Create a one-click installer for your macOS application. Save your users from cognitive load when choosing the right file for their processor type (x86_64 or arm64), ensuring installation simplicity.
- Support for 2 source options for downloading application files: GitHub Releases and Direct URLs
- Localization in 14 languages: English, Bulgarian, Chinese (Simplified), French, German, Hindi, Italian, Japanese, Korean, Portuguese, Russian, Spanish, Turkish, Vietnamese
- The installer skips downloading application files if the app is already installed on the user's device
- Confirmation prompt when exiting the installer during download or installation
Important
Xcode 26+ is required if you want to use the new *.icon icon type via Icon Composer. Please note that this will increase the installer size from 572 KB to 4.1 MB. By default, the older *.icns icon type is used.
Clone the project repository:
git clone https://github.com/doroved/mac-installer.git
cd mac-installerNavigate to the project settings (Xcode) and make the following changes:
General→Display Name— replaceAppNamewith your application nameSigning & Capabilities→Bundle Identifier— replacecom.appname.installerwith a unique identifier for your installer
In the AppConfig.swift file:
- Specify your application name in
appNameas it appears in/Applications - Choose the application file download method (
downloadType):github— for downloading from GitHub Releasesdirect— for direct download via URL
- Specify URLs for
latestReleaseURL,arm64URL,x86_64URLdepending on the chosen download method
In Assets.xcassets, replace the icon with your application's icon.
- Navigate to
Product→Archiveto create a project archive - After creating the archive, click the
Distribute Appbutton, selectDirect Distribution, and clickDistribute - Wait for the process to complete and click
Exportto save the installer as a.appfile
- ProxerInstallerAppIcon 572 КБ
- ProxerInstallerIconComposer 4.1 МБ