Generate an archive and installer
deploy.bat script from the scripts/win directory generates a Launcher build archive for automatic update delivery to the users.
You can launch
- double-clicking the script file — this will place the build in the cloned project folder > target subfolder;
- from the command line prompt, using an additional
--out <directory>key, where
<directory>is your desired build installation path.
deploy.bat --out C:/Target
To generate a Launcher installer and get a link to deliver it to users:
- In Publisher Account go to Launcher > General settings and click Generate link to installer for Windows.
- In the window that appears, upload a ZIP Launcher build archive and an ICO installer icon. Click Generate.
- Wait for the installer to be generated, signed with an Xsolla certificate, and uploaded to the Xsolla CDN.
- Copy the link to the web installer to distribute it to your users. To get a link to the stand-alone installer, select Get link to stand-alone installer from the drop-down menu.
deploy.sh script from the scripts/macOS/ directory generates:
- A Launcher installer that you can send to new users.
- A Launcher build archive for automatic update delivery to the users.
- An APP file.
For the security system of macOS to identify your Launcher build as a safe one, you need to:
- Sign the build with the developer certificate.
- Notarize your build by Apple.
deploy.shscript. Follow the instructions below to prepare for signing the build and run the script.
To sign and verify the app, you must have:
- Xcode 11
- an individual or a company Apple account
- a developer certificate
- a certificate signature
- an app-specific password
- a Bundle ID
Generating an app-Specific password
- Go to Apple ID.
- Pass the two-factor authentication.
- Go to the Security section.
- Click Generate Password.
- Type a label for the password and click Create.
Getting the certificate signature
- Open the Keychain Access app.
- Go to Keychain Access > Certificate Assistant and select Request a Certificate From a Certificate Authority.
- Enter your data in the window that appears, select Save to disk, and click Continue.
- Specify the path to the folder where you want to save the certificate and click Save.
- Go to Apple Developer and log in.
- Go to Certificates, Identifiers & Profiles, open the Certificates tab, and add a new certificate.
- Set the certificate type to Developer ID Application and click Continue.
- Select the file with the generated certificate and click Continue.
- Click Download to download the developer certificate.
- Open the downloaded file and install the certificate.
- Open the terminal and run the
security find-identity -p basic -vcommand.
Registering a bundle ID
- Go to Apple Developer.
- Go to Certificates, Identifiers & Profiles, open the Identifiers tab, and add a new identifier.
- Select the App IDs type and click Continue.
- Set the app type to App and click Continue.
- Insert the Bundle ID. Example:
com.template.launcher. Click Continue.
- Make the following edits in the
- Set the
parameter value to your bundle ID.
- Set values of the
parameters to the app version number.
- Set the
<key>CFBundleIdentifier</key> <string>com.template.launcher</string> <key>CFBundleVersion</key> <string>102</string> <key>CFBundleShortVersionString</key> <string>1.0.102</string>
Running a script
When you have completed all the preparation steps, run the following commands:
chmod +x deploy.sh ./deploy.sh --username <username> --password <password> --signature <signature> --teamid <teamid> --apppath <apppath> --appname <appname> --outpath <outpath>
apppath— a path to the Launcher build you want to sign. Required. Default is
username— a name of the Apple developer account user. Required. Example:
password— an app-specific password. Required.
appname— a Launcher build name. Optional. Default is
signature— a certificate signature. Required. Example:
Developer ID Application: John Smith (JWZ3331234).
teamid— an ID of the team. Required. To get it, run the
xcrun altool --list-providers -u "AC_USERNAME" -p "AC_PASSWORD"command.
bundleid— an application ID, or a Bundle ID. Optional. Default is
outpath— a path to the directory to place the signed APP file, archive, and the DMG Launcher installation file. Optional. Default is
If you get the altool cannot be found error, run the
xcrun altool command. In case it returns another error, run the
xcode-select -r command.