Generate an archive and installer
The deploy.bat
script from the scripts/win
directory generates a Launcher build archive for automatic update delivery to the users.
You can launch deploy.bat
by:
- 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.
Example
- php
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.
The 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.sh
script. Follow the instructions below to prepare for signing the build and run the script.Preparation steps
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 -v
command.
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
Info.plist
config-file:- Set the
parameter value to your bundle ID.CFBundleIdentifier - Set values of the
andCFBundleVersion
parameters to the app version number.CFBundleShortVersionString
- Set the
Example
- php
<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:
- php
chmod +x deploy.sh
./deploy.sh --username <username> --password <password> --signature <signature> --teamid <teamid> --apppath <apppath> --appname <appname> --outpath <outpath>
Command-line arguments:
apppath
— a path to the Launcher build you want to sign. Required. Default is../../launcher/macos
.username
— a name of the Apple developer account user. Required. Example:j.smith@email.com
.password
— an app-specific password. Required.appname
— a Launcher build name. Optional. Default islauncher
.signature
— a certificate signature. Required. Example:Developer ID Application: John Smith (JWZ3331234)
.teamid
— an ID of the team. Required. To get it, run thexcrun altool --list-providers -u "AC_USERNAME" -p "AC_PASSWORD"
command.bundleid
— an application ID, or a Bundle ID. Optional. Default iscom.template.launcher
.outpath
— a path to the directory to place the signed APP file, archive, and the DMG Launcher installation file. Optional. Default is$apppath/../../target/macos
.

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.
Was this article helpful?
Rate this page
Don’t want to answer
Thank you for your feedback!
Continue reading
Next steps
Upload game buildFound a typo or other text error? Select the text and press Ctrl+Enter.