This plugin lets you automatically rewrite UIKit/SwiftUI image and colour instantations from unreliable string-based inits such as:
UIImage(named: "some icon")
Image("some icon")
UIColor(named: "light blue green")
Color("light blue green")into ImageResource and ColorResource literals (as introduced in Xcode 15) such as:
UIImage(resource: .someIcon)
Image(.someIcon)
UIColor(resource: .lightBlueGreen)
Color(.lightBlueGreen)- In Xcode, go to File → Add Package Dependencies and enter the URL for this repository.
- In the following popup, select Add to Target: None as the package is for running only in Xcode and not part of your app itself.
- In case your application is split into several packages, as is increasingly common, you also need to add the dependency to your package's
Package.swiftfile to process images in that package:
dependencies: [
.package(url: "https://github.com/idrougge/ResourceRewriterForXcode.git", branch: "main"),
]After a rebuild, a secondary click on your project (or package) in the Project Navigator brings up a menu where you will now find the options "Rewrite image resource strings" and "Rewrite colour resource strings". Select that option and the target where you want your asset references to be fixed up.
As the UIImage(named:) init returns an optional and UIImage(resource:) does not, you may now have if let, guard let or nil coalescing (??) statements that are no longer necessary. These you will have to fix up by yourself as it is beyond the capabilities of a simple plugin.
If you have turned off generated asset symbols, go into your build settings and enable Generate Asset Symbols (ASSETCATALOG_COMPILER_GENERATE_ASSET_SYMBOLS) or the resource names will not resolve.
After you are done, you are free to remove this dependency again, possibly introducing a linter rule forbidding calls to string-based asset inits.
- Short-hand calls such as
image = .init(named: "Something")aren't handled. - Any image name built with string interpolation or concatenation is untouched as those must be resolved at run-time.
- The plugin strives to follow Xcode's pattern for translating string-based asset names into
ImageResource/ColorResourcenames but there may be cases where this does not match. Please open an issue in that case so it may added. - Functions or enums that return or accept string names, as well as wrapper functions or generated code must be rewritten manually if you wish to use
ImageResource/ColorResourcefor those. You may fork and customise this plugin if such uses permeate your project.