Das Skript deploy.bat aus dem Verzeichnis scripts/win generiert ein Build-Archiv für das Startprogramm zur automatischen Auslieferung von Updates an Benutzer.

Sie können die deploy.bat folgendermaßen ausführen:

• durch Doppelklick auf die Skript-Datei — dadurch wird die Build im geklonten Projektordner > Ziel-Unterordner abgelegt;
• über die Eingabeaufforderung unter Verwendung eines zusätzlichen --out <directory> Schlüssels, wobei <directory> den gewünschten Installationspfad der Build darstellt.

BEISPIEL

deploy.bat --out C:/Target

So generieren Sie einen Startprogramm-Installer und rufen den Link für die Bereitstellung an die Benutzer ab:

1. Navigieren Sie im Kundenportal zu Startprogramm > Allgemeine Einstellungen, und klicken Sie auf Installer-Link für Windows generieren.
2. Laden Sie im sich daraufhin öffnenden Fenster das Startprogramm-Buildarchiv im ZIP-Format und das Installer-Symbol im ICO-Format hoch. Klicken Sie auf Generieren.
3. Warten Sie, bis der Installer generiert, mit einem Xsolla-Zertifikat signiert und in das Xsolla-CDN hochgeladen ist.
4. Kopieren Sie den Link des Web-Installers und senden Sie ihn an Ihre Benutzer. Um den Link eines eigenständigen Installers abzurufen, wählen Sie im Drop-down-Menü die Option Link des eigenständigen Installers abrufen aus.

Das Skript deploy.sh aus dem Verzeichnis scripts/macOS/ generiert:

• ein Installationsprogramm für das Startprogramm, welches an neue Nutzer versendet werden kann;
• ein Build-Archiv für das Startprogramm zur automatischen Auslieferung von Updates an Benutzer.
• eine APP-Datei.

Damit das Sicherheitssystem von macOS Ihre Startprogramm-Build als sicher einstuft, müssen Sie:

1. die Build mit dem Entwicklerzertifikat signieren
2. hre Build von Apple notariell beglaubigen lassen.

Schritte zur Vorbereitung

Um die App signieren und verifizieren zu können, benötigen Sie Folgendes:

• Xcode11
• ein persönliches oder ein Unternehmenskonto bei Apple
• ein Entwicklerzertifikat
• eine Zertifikatsignatur
• ein anwendungsspezifisches Passwort
• eine Bundle-ID

Generieren eines anwendungsspezifischen Passworts

1. Wechseln Sie zu Ihrem Apple ID-Konto.
2. Melden Sie sich per Zwei-Faktor-Authentifizierung an.
3. Scrollen Sie zum Abschnitt Sicherheit.
4. Klicken Sie auf Passwort erstellen.

5. Geben Sie eine Bezeichnung für das Passwort ein, und klicken Sie auf Erstellen.

Abrufen der Zertifikatsignatur

1. Öffnen Sie die App Schlüsselbundverwaltung.
   1. Navigieren Sie zu Schlüsselbundverwaltung > Zertifikatsassistent, und wählen Sie Zertifikat einer Zertifizierungsinstanz anfordern aus.

2. Geben Sie im sich daraufhin öffnenden Fenster Ihre Daten ein, wählen Sie Auf Festplatte speichern aus, und klicken Sie auf Fortfahren.
2. Geben Sie den Pfad des Ordner an, in dem Sie Ihr Zertifikat speichern wollen, und klicken Sie auf Speichern.
3. Melden Sie sich bei Ihrem Apple Developer-Konto an.
   1. Navigieren Sie zu Certificates, Identifiers & Profiles, öffnen Sie die Registerkarte Certificates, und fügen Sie ein neues Zertifikat hinzu.

2. Setzen Sie den Zertifikatstyp auf Developer ID Application, und klicken Sie auf Continue.
3. Wählen Sie die Datei mit dem generierten Zertifikat aus, und klicken Sie auf Continue.
4. Klicken Sie auf Download, um das Entwicklerzertifikat herunterzuladen.
4. Öffnen Sie die heruntergeladene Datei, und installieren Sie das Zertifikat.
5. Öffnen Sie Terminal und führen Sie den Befehl security find-identity -p basic -v aus.

Registrieren einer Bundle-ID

1. Wechseln Sie zu Ihrem Apple Developer-Konto.
   1. Navigieren Sie zu Certificates, Identifiers & Profiles, öffnen Sie die Registerkarte Identifiers, und fügen Sie eine neuen Identifier hinzu.

2. Wählen Sie als Typ App IDs, und klicken Sie auf Continue.
3. Stellen Sie den Typ der App auf App, und klicken auf Sie Continue.

4. Geben Sie die Bundle-ID ein. Beispiel: com.template.launcher. Klicken Sie auf Continue.
2. Nehmen Sie an der Info.plist-Konfigurationsdatei folgende Änderungen vor:
   1. Legen Sie als Wert für den Parameter CFBundleIdentifier Ihre Bundle-ID fest.
   2. Legen Sie als Wert für die Parameter CFBundleVersion und CFBundleShortVersionString die Versionsnummer der App fest.

BEISPIEL

<key>CFBundleIdentifier</key>
<string>com.template.launcher</string>
<key>CFBundleVersion</key>
<string>102</string>
<key>CFBundleShortVersionString</key>
<string>1.0.102</string>

Ausführen eines Skripts

Wenn Sie alle Vorbereitungsschritte abgeschlossen haben, führen Sie folgende Befehle aus:

chmod +x deploy.sh
./deploy.sh --username <username> --password <password> --signature <signature> --teamid <teamid> --apppath <apppath> --appname <appname> --outpath <outpath>

Befehlszeilenargumente:

• apppath — Pfad der zu signierenden Startprogramm-Build. Erforderlich. Standardwert: ../../launcher/macos.
• username — Name des Apple Developer-Kontoinhabers. Erforderlich. Beispiel: j.smith@email.com.
• password — ein anwendungsspezifisches Passwort. Erforderlich.
• appname — Name der Startprogramm-Build. Optional. Standardwert: launcher.
• signature — Zertifikatsignatur. Erforderlich. Beispiel: Developer ID Application: John Smith (JWZ3331234).
• teamid — ID des Teams. Erforderlich. Zum Abrufen den Befehl xcrun altool --list-providers -u "AC_USERNAME" -p "AC_PASSWORD" ausführen.
• bundleid — Anwendungs-ID oder Bundle-ID. Optional. Standardwert: com.template.launcher.
• outpath — Pfad des Verzeichnisses, in dem die signierte APP-Datei, das Archiv und die DMG-Installationsdatei des Startprogramms abgelegt werden sollen. Optional. Standardwert: $apppath/../../target/macos. Wenn der Signierungs- und Beglaubigungsprozess ohne Fehler verlief, zeigt Terminal folgende Meldung an:

  

  Wenn Sie die Fehlermeldung altool kann nicht gefunden werden erhalten, führen Sie den Befehl xcrun altool aus. Im Falle, dass ein anderer Fehler erscheint, führen Sie den Befehl xcode-select -r aus.