mac-cain13/R.swift
R.swift
R.swift is a resource generator and build tool plugin for Swift projects that creates type-safe accessors for bundle resources. It maps images, colors, localized strings, and bundle files to autocompleted Swift constants, replacing hardcoded string identifiers with strongly typed wrappers to ensure compile-time validation.
The system functions as an asset wrapper that integrates into the build process to synchronize resource identifiers with source code. It utilizes static resource analysis to transform project configuration settings, entitlement values, and asset catalogs into a structured API.
The tool covers a broad range of resource management, including the retrieval of custom fonts and the management of UI components such as storyboards, nibs, view controller segues, and reusable cells. It also provides interfaces for accessing project metadata and localized strings.
Users can configure the generation process by selecting specific resource generators and using pattern-based filtering to include or exclude certain assets.
Features
- Build-Time Code Generators - Provides a build-time system that generates Swift source files to provide type-safe references to project assets.
- iOS Asset and Localization Management - Generates automatic Swift accessors for iOS asset catalogs, custom fonts, and bundle files.
- String Localization - Provides a strongly typed interface for retrieving and formatting localized strings from dictionary files.
- Type-Safe Asset Retrieval - Retrieves image assets and color definitions from catalogs through a strongly typed interface.
- Compile-Time Type Generation - Automatically creates type definitions based on the project's resource catalogs and file structures.
- Resource Accessor Generators - Creates type-safe Swift accessors for images, fonts, and strings to replace hardcoded resource identifiers.
- Type-Safe Resource Accessors - Replaces hardcoded strings with type-safe identifiers for images, colors, and fonts to prevent runtime crashes.
- Type-Safe Asset Accessors - Maps string-based resource identifiers to generated Swift types to prevent runtime crashes and enable autocompletion.
- Asset Reference Wrappers - Implements a code generation system that provides compile-time checks for assets and storyboard references.
- Resource Identifier Wrappers - Wraps raw string identifiers in specialized Swift types to ensure compile-time validation of resource availability.
- Resource Accessor Generators - Creates a type-safe interface for accessing assets to provide autocompletion and prevent runtime crashes.
- Asset Catalog Analysis - Scans asset catalogs and storyboard files to extract identifiers for transformation into type-safe Swift code.
- Type-Safe Font Loading - Retrieves custom font files loaded in the bundle through a strongly typed interface.
- Build Tool Plugins - Integrates into the Swift build process as a plugin to automatically synchronize resource identifiers.
- File and Resource Management - Offers a type-safe way to retrieve paths and URLs for miscellaneous files stored in the app bundle.
- Project Configuration - Provides a strongly typed interface to retrieve application metadata and build settings from project configuration.
- Storyboard and Nib Type-Safety - Ensures compile-time safety for storyboard identifiers, view controller segues, and reusable cells.
- Type-Safe Segue References - Retrieves destination controllers and identifiers using strong types to prevent runtime errors during screen transitions.
- Project Configuration APIs - Transforms project configuration and entitlement values into a structured, strongly typed Swift API.
- Resource Existence Validation - Checks whether assets exist at runtime to prevent crashes caused by missing files.
- Storyboard Controller Instantiation - Enables type-safe lookup and instantiation of view controllers from storyboards and nib files.
- Development Toolchains - Tool for type-safe resource access in Swift.
- Development Utilities - Tool for type-safe resource access.
- General Utilities - Strongly typed, autocompleted resources like images and segues.
