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.
226 Dec 24, 2022
377 Dec 1, 2022
8.9k Jan 6, 2023
8.3k Jan 5, 2023
7.2k Jan 3, 2023
1.3k Dec 28, 2022
142 Sep 9, 2022
123 Jun 29, 2022
60 Dec 12, 2022
143 Oct 11, 2022
17 Jun 27, 2022
6 Jul 13, 2021
281 Jan 15, 2022
0 Dec 9, 2021
41 Nov 28, 2022
21 Jan 5, 2023
7 Dec 23, 2022
348 Sep 18, 2022
1.9k Dec 27, 2022
338 Nov 29, 2022
822 Dec 21, 2022
238 Sep 12, 2022
73 Nov 9, 2020
2k Dec 11, 2022
233 Dec 28, 2022
234 Jan 9, 2023