A plugin to generate Swift constants for your String Catalogs.
Hardcoding localized strings in your code and then having the compiler automatically extract them into the Strings Catalog (or legacy .strings files) works great on smaller projects, but over time you will often find that this approach doesn't scale well.
You usually find yourself compromising on either code quality, translator comments or boilerplate code from having to define your own constants, but it doesn't have to be this way!
struct ContentView: View {
@Query var items: [Item]
var body: some View {
List {
Section {
ForEach(items) { item in
ItemView(item)
}
} footer: {
Text(.localizable.footerText(items.count))
}
}
.navigationTitle(Text(.localizable.contentViewTitle))
}
}XCStrings Tool aims to extend your localization experience so that you don't have to compromise anything. It does this by using your Strings Catalog as a source for generating elegant Swift code that you can reference directly within the rest of your project.
Note
While Strings Catalogs are fully backwards compatible, code generated using XCStrings Tool supports iOS 15/macOS 12/watchOS 8/tvOS 15 or later.
XCStrings Tool is a Swift Package Plugin that can integrate directly into Xcode and Swift Package targets that contain Strings Catalog (.xcstrings) files.
- Integrating XCStrings Tool into an Xcode Project Target
- Integrating XCStrings Tool into a Swift Package Target
For more information about the Strings Catalog format, check out the Discover Strings Catalogs video from WWDC 2023.
To see XCStrings Tool in action, check out the Dog Tracker demo project for yourself.
View the documentation on the Swift Package Index
If you have an improvement for the documentation, you can modify it here.
Contributions to XCStrings Tool are welcome!
- For ideas and questions: Visit the Discussions
- For bugs: Open an Issue
- For contributions: Open a Pull Request