Misen
Misen is a script to support using Xcode Asset Catalog in Swift.
Features
Misen scans sub-directories in the specified Asset Catalog and creates a UIImage extension file which has the following features.
- Application-specific enum which is constructed from Asset Catalog names and UIImage object can be instantiated directly from it.
- UIImage non-failable initializer whose argument is an enum value above.
Usage
- Change file permissions first.
chmod +x misen.swift
- Run the script.
./misen.swift -path PATH/TO/XCASSETS -exportPath PATH/TO/GENERATED_FILE -enumName ENUM_NAME
-pathis a path of the asset catalog.-exportPathis an output UIImage extension file path.-enumNameis an enum name to be generated. This is optional andImageAssetis used as default when this parameter is not specified.
e.g.
Misen generates the file below from the asset catalog with 3 image sets below.
For reference, see the script of the sample project.
import UIKit
// MARK: - UIImage extension
extension UIImage {
convenience init!(assetName: ImageAsset) {
self.init(named: assetName.rawValue)
}
}
// MARK: - ImageAsset
enum ImageAsset: String {
case camera = "camera"
case contact = "contact"
case home = "home"
var image: UIImage {
return UIImage(named: self.rawValue)!
}
}
- In your code, you can instantiate images in Asset Catalog as follows.
class ViewController: UIViewController {
@IBOutlet weak var cameraImageView: UIImageView! {
didSet {
// Instantiate UIImage directly from ImageAsset enum
cameraImageView.image = ImageAsset.camera.image
}
}
@IBOutlet weak var contactImageView: UIImageView! {
didSet {
contactImageView.image = ImageAsset.contact.image
}
}
@IBOutlet weak var homeImageView: UIImageView! {
didSet {
// Instantiate UIImage with UIImage extension
homeImageView.image = UIImage(assetName: .home)
}
}
...
}
Requirements
- Xcode 8.0
- Swift 3.0
Release Notes
See Releases.
License
Misen is released under the MIT license. See LICENSE for details.
555 Dec 17, 2022
2.8k Jan 7, 2023
478 Dec 17, 2022
1.3k Dec 20, 2022
534 Jan 3, 2023
24.4k Jan 5, 2023
2.7k Dec 21, 2022
2.4k Jan 5, 2023
16 Jan 4, 2023
116 Nov 14, 2022
77 Dec 27, 2022
29 Aug 18, 2018
4 Dec 23, 2022
601 Dec 26, 2022
2.6k Jun 21, 2021
4.3k Jan 2, 2023
815 Dec 30, 2022
45 Dec 2, 2022
0 Dec 15, 2021