How do I generate icons for iMessage sticker packs with appicon?

Set messages_extension to true and include :messages in appicon_devices, then specify the output path for the Messages extension assets, as shown in the messages_extension lane example in the README.

What's better for icon generation: appicon or manual resizing in Photoshop?

Appicon is better for automation and consistency in fastlane-based workflows, while manual resizing offers more creative control but is time-consuming and error-prone for multiple platform sizes.

Can appicon create rounded notification icons for Android?

Yes, by setting generate_rounded to true in the android_appicon action for notification icons, it produces circular icons compliant with Android design guidelines, as detailed in the Android example.

How to troubleshoot appicon plugin not generating icons correctly?

Check that GraphicsMagick or ImageMagick is installed and accessible, verify the source image path and parameters in your Fastfile, and refer to the Plugins Troubleshooting guide linked in the README.

Does appicon support the latest iOS icon sizes for new devices?

The plugin aims to cover standard platform requirements, but you should verify its version against Apple's latest guidelines, as updates may be needed for new icon dimensions.

How to generate splash screen assets for Android using appicon?

Use the android_appicon action with appicon_icon_types set to [:splash_port, :splash_land] and specify the appicon_path, as illustrated in the Android splash screen example lane.

Open-Awesome

fastlane-plugin-appicon

MITRubyv0.16.0

A fastlane plugin that generates all required iOS, Android, and macOS app icon sizes from a single master image.

GitHub

341 stars51 forks0 contributors

What is fastlane-plugin-appicon?

fastlane-plugin-appicon is a Ruby gem that automates the generation of application icons for iOS, Android, and macOS platforms. It takes a single high-resolution master icon and produces all the required sizes and formats for each platform, eliminating the manual work of resizing and organizing icon assets. The plugin integrates directly into fastlane automation workflows, making it part of continuous integration and deployment pipelines.

Target Audience

Mobile developers (iOS and Android) and macOS app developers who need to generate multiple icon sizes for app store submissions and distribution. Teams using fastlane for build automation will find it particularly valuable.

Value Proposition

Developers choose this plugin because it saves significant time compared to manual icon generation, ensures consistency across all icon sizes, and integrates seamlessly with existing fastlane automation. It supports all major Apple and Android platforms from a single configuration.

Overview

Generate required icon sizes and iconset from a master application icon.

Use Cases

Best For

Automating icon generation in CI/CD pipelines for mobile apps
iOS developers needing App Store Connect compliant icon sets
Android projects requiring multiple density launcher and notification icons
Teams building cross-platform apps (iOS, Android, macOS)
Creating iMessage sticker pack icons for Messages extensions
Generating splash screen assets for Android applications

Not Ideal For

Projects not using fastlane or Ruby-based build automation
One-off icon generation tasks where manual tools or online services are simpler
Teams that prefer graphical user interfaces over command-line workflows
Apps with non-standard icon dimensions requiring custom, unsupported sizes

Pros & Cons

Pros

Automated Multi-Platform Generation

Generates icons for iOS, Android, macOS, and universal apps from a single 1024x1024 master image, saving time and ensuring consistency across all required sizes as highlighted in the README.

Seamless Fastlane Integration

Integrates directly into fastlane workflows, allowing automation in CI/CD pipelines with simple lane configurations, as demonstrated in the example Fastfile snippets.

Flexible Device Targeting

Supports precise control over icon generation for specific devices using the appicon_devices parameter, enabling tailored asset creation for platforms like iPhone, iPad, or watchOS.

Handles Edge Cases

Includes specialized support for Messages extensions and Android splash screens, addressing niche but common mobile development needs with dedicated parameters like messages_extension and generate_rounded.

Cons

External Library Dependency

Requires installation of GraphicsMagick or ImageMagick, adding setup complexity and potential system compatibility issues, as noted in the Getting Started section.

Fastlane Ecosystem Lock-in

Only functions within fastlane environments, making it unsuitable for teams not already invested in or unwilling to adopt fastlane for build automation.

Limited Customization Options

Focuses on standard platform icon sizes; generating non-standard dimensions or applying advanced image effects may require manual intervention or additional tools beyond the plugin's scope.

Frequently Asked Questions

Related Projects

infer

A static analyzer for Java, C, C++, and Objective-C

Stars15,627

Forks2,093

Last commit2 days ago

R.swift

Strong typed, autocompleted resources like images, fonts and segues in Swift projects

Stars9,573

Forks779

Last commit1 year ago

SwiftGen

The Swift code generator for your assets, storyboards, Localizable.strings, … — Get rid of all String-based APIs!

Stars9,537

Forks766

Last commit1 month ago

XcodeGen

A Swift command line tool for generating your Xcode project

Stars8,473

Forks883