View a markdown version of this page

Tutorial: Apple-Codesigning mit Fastlane bei der CodeBuild Verwendung GitHub zur Zertifikatsspeicherung - AWS CodeBuild
VoraussetzungenSchritt 1: Richten Sie Fastlane Match mit GitHub auf Ihrem lokalen Computer einSchritt 2: Richten Sie Ihr Fastfile einSchritt 3: Führen Sie den Befehl fastlane match aus, um die entsprechenden Zertifikate und Profile zu generierenSchritt 4: Erstellen Sie die Anwendungsdatei für Ihr ProjektSchritt 5: Erstellen Sie Umgebungsvariablen im Secrets ManagerSchritt 6: Erstellen Sie eine ComputerflotteSchritt 7: Erstellen Sie ein Projekt in CodeBuildSchritt 8: Führen Sie den Build ausFehlerbehebungSicherheitsüberlegungen

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Tutorial: Apple-Codesigning mit Fastlane bei der CodeBuild Verwendung GitHub zur Zertifikatsspeicherung

Fastlane ist ein beliebtes Open-Source-Automatisierungstool zur Automatisierung von Beta-Bereitstellungen und -Releases für Ihre iOS- und Android-Apps. Es erledigt alle mühsamen Aufgaben, wie das Generieren von Screenshots, das Codesignen und das Veröffentlichen Ihrer Anwendung.

Dieses Beispiel zeigt, wie Sie Apple-Codesigning mithilfe von Fastlane in einem CodeBuild Projekt einrichten, das auf einer Mac-Flotte läuft und GitHub als Speicher für Zertifikate und Bereitstellungsprofile dient.

Voraussetzungen

Um dieses Tutorial abzuschließen, müssen Sie zunächst Folgendes eingerichtet haben:

  • Und AWS-Konto

  • Ein Apple-Entwicklerkonto

  • Ein privates GitHub Repository zum Speichern von Zertifikaten

  • Fastlane ist in Ihrem Projekt installiert - Anleitung zur Installation von Fastlane

Schritt 1: Richten Sie Fastlane Match mit GitHub auf Ihrem lokalen Computer ein

Fastlane Match ist eines der Fastlane-Tools und ermöglicht eine nahtlose Konfiguration für die Codesignatur sowohl in Ihrer lokalen Entwicklungsumgebung als auch auf anderen Geräten. CodeBuild Fastlane Match speichert alle Ihre Codesignaturzertifikate und Bereitstellungsprofile in einem Git repository/S3 Bucket/Google Cloud-Speicher und lädt bei Bedarf die erforderlichen Zertifikate und Profile herunter und installiert sie.

In dieser Beispielkonfiguration werden wir ein Git-Repository für die Speicherung einrichten und verwenden.

  1. Initialisieren Sie Match in Ihrem Projekt:

    fastlane match init

  2. Wenn Sie dazu aufgefordert werden, wählen Sie GitHub als Speichermodus.

  3. Aktualisiere dein `Matchfile`, um Folgendes zu verwenden GitHub:

    git_url("https://github.com/your-username/your-certificate-repo.git")
storage_mode("git")
type("development") # The default type, can be: appstore, adhoc, enterprise or development
Anmerkung

Stellen Sie sicher, dass Sie die HTTPS-URL für Ihr Git-Repository eingeben, damit Fastlane sich erfolgreich authentifizieren und klonen kann. Andernfalls wird möglicherweise ein Authentifizierungsfehler angezeigt, wenn Sie versuchen, Match zu verwenden.

Schritt 2: Richten Sie Ihr Fastfile ein

Erstellen oder aktualisieren Sie Ihr `Fastfile` mit der folgenden Spur.

Nein CodeBuild, Fastlane Match muss jedes Mal ausgeführt werden, wenn du deine App erstellst und signierst. Der einfachste Weg, dies zu tun, besteht darin, die match Aktion zu der Lane hinzuzufügen, auf der Ihre App erstellt wird.

default_platform(:ios)

platform :ios do
  before_all do
    setup_ci
  end
  
  desc "Build and sign the app"
  lane :build do
    match(type: "appstore", readonly: true)
    gym(
      scheme: "YourScheme",
      export_method: "app-store"
    )
  end
end
Anmerkung

Stellen Sie sicher, dass setup_ci Sie den before_all Abschnitt erweitern, Fastfile damit die Match-Aktion ordnungsgemäß funktioniert. Dadurch wird sichergestellt, dass ein temporärer Fastlane-Schlüsselbund mit den entsprechenden Berechtigungen verwendet wird. Ohne dies zu verwenden, kann es zu Build-Fehlern oder inkonsistenten Ergebnissen kommen.

Schritt 3: Führen Sie den Befehl fastlane match aus, um die entsprechenden Zertifikate und Profile zu generieren

Der Fastlane-Match-Befehl für den angegebenen Typ (d. h. Entwicklung, Appstore, Adhoc, Unternehmen) generiert das Zertifikat und das Profil, falls sie nicht im Remote-Store verfügbar sind. Die Zertifikate und Profile werden von Fastlane gespeichert. GitHub 

bundle exec fastlane match appstore

Die Befehlsausführung erfolgt interaktiv und Fastlane fordert Sie auf, eine Passphrase für die Entschlüsselung der Zertifikate festzulegen.

Schritt 4: Erstellen Sie die Anwendungsdatei für Ihr Projekt

Erstellen Sie die für Ihr Projekt geeignete Anwendungsdatei oder fügen Sie sie hinzu.

  1. Erstellen Sie Gymfile, Appfile, Snapfile, Deliverfile oder fügen Sie es hinzu, basierend auf Ihren Projekt-Build-Anforderungen.

  2. Übernehmen Sie die Änderungen in Ihr Remote-Repository.

Schritt 5: Erstellen Sie Umgebungsvariablen im Secrets Manager

Erstellen Sie drei Geheimnisse zum Speichern des Fastlane-Sitzungscookies und der passenden Passphrase. Weitere Informationen zum Erstellen von Geheimnissen im Secrets Manager finden Sie unter Ein AWS Secrets Manager Geheimnis https://docs.aws.amazon.com/secretsmanager/latest/userguide/create_secret.html erstellen.

  1. Greifen Sie wie folgt auf Ihr Fastlane-Sitzungscookie zu.

    1. Geheimer Schlüssel - FASTLANE_SESSION

    2. Geheimer Wert — Sitzungscookie, das durch die Ausführung des folgenden Befehls auf Ihrem lokalen Computer generiert wurde.

      Anmerkung

      Dieser Wert ist nach der Authentifizierung in einer lokalen Datei verfügbar:~/.fastlane/spaceship/my_appleid_username/cookie.

      fastlane spaceauth -u <Apple_account>

  2. Fastlane Match-Passphrase — Damit Fastlane Match die im Git-Repository gespeicherten Zertifikate und Profile entschlüsseln kann, müssen Sie die Verschlüsselungspassphrase, die Sie im Einrichtungsschritt Match konfiguriert haben, zu den Umgebungsvariablen des Projekts hinzufügen. CodeBuild

    1. Geheimer Schlüssel - MATCH_PASSWORD

    2. Geheimer Wert -<match passphrase to decrypt certificates>. Die Passphrase wird beim Generieren der Zertifikate in Schritt 3 festgelegt.

  3. Fastlane MATCH_GIT_BASIC_AUTHORIZATION — legen Sie eine grundlegende Autorisierung für Match fest:

    1. Geheimer Schlüssel:

      MATCH_GIT_BASIC_AUTHORIZATION

    2. Geheimer Wert — Der Wert sollte eine Base64-kodierte Zeichenfolge Ihres Benutzernamens und Ihres persönlichen Zugriffstokens (PAT) im Format sein. username:password Sie können ihn mit dem folgenden Befehl generieren:

      echo -n your_github_username:your_personal_access_token | base64

      Sie können Ihr PAT auf der GitHub Konsole unter „Mein Profil“ > „Einstellungen“ > „Entwicklereinstellungen“ > „Persönliches Zugriffstoken“ generieren. Weitere Informationen finden Sie in der folgenden Anleitung: https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens.

Anmerkung

Denken Sie beim Erstellen der oben genannten Geheimnisse im Secrets Manager daran, einen geheimen Namen mit dem folgenden Präfix anzugeben: /CodeBuild/

Schritt 6: Erstellen Sie eine Computerflotte

Erstellen Sie die Rechenflotte für Ihr Projekt.

  1. Gehen Sie in der Konsole zu CodeBuild und erstellen Sie eine neue Rechenflotte.

  2. Wählen Sie macOS als Betriebssystem und wählen Sie einen geeigneten Rechnertyp und ein entsprechendes Image aus.

Schritt 7: Erstellen Sie ein Projekt in CodeBuild

Erstellen Sie Ihr Projekt in CodeBuild.

  1. Öffnen Sie die AWS CodeBuild Konsole unter https://console.aws.amazon.com/codesuite/codebuild/home.

  2. Erstellen Sie ein Build-Projekt. Weitere Informationen finden Sie unter Erstellen Sie ein Build-Projekt (Konsole) und Ausführen eines Build (Konsole).

  3. Richten Sie Ihren Quellanbieter ein (z. B. GitHub, CodeCommit). Dies ist das Quell-Repository für iOS-Projekte und kein Zertifikat-Repository.

  4. In Environment (Umgebung):

    • Wählen Sie Reservierte Kapazität.

    • Wählen Sie für Flotte die oben erstellte Flotte aus.

    • Geben Sie den Namen der Servicerolle ein, die für Sie erstellt CodeBuild wird.

    • Geben Sie die folgenden Umgebungsvariablen an.

      • Name:MATCH_PASSWORD, Wert:<secrets arn>, Typ: Secrets Manager (Secrets ARN wurde in Schritt 5 für MATCH_PASSWORD erstellt)

      • Name:FASTLANE_SESSION, Wert:<secrets arn>, Typ: Secrets Manager (Secrets ARN wurde in Schritt 5 für FASTLANE_SESSION erstellt)

      • Name:MATCH_GIT_BASIC_AUTHORIZATION, Wert:<secrets ARN>, Typ: Secrets Manager Secrets ARN (erstellt in Schritt 5 für) MATCH_GIT_BASIC_AUTHORIZATION

  5. Fügen Sie in Buildspec Folgendes hinzu:

    version: 0.2

phases:
  install:
    commands:
      - gem install bundler
      - bundle install
  build:
    commands:
      - echo "Building and signing the app..."
      - bundle exec fastlane build
  post_build:
    commands:
      - echo "Build completed on date"

artifacts:
  files:
    - '*/.ipa'
  name: app-$(date +%Y-%m-%d)

Schritt 8: Führen Sie den Build aus

Führen Sie den Build aus. Sie können den Build-Status überprüfen und sich anmelden CodeBuild.

Sobald der Job abgeschlossen ist, können Sie das Protokoll des Jobs einsehen.

Fehlerbehebung

  • Wenn Sie Probleme beim Zugriff auf das GitHub Repository haben, überprüfen Sie Ihr persönliches Zugriffstoken und die Umgebungsvariable MATCH_GIT_BASIC_AUTHORIZATION.

  • Wenn Sie Probleme mit der Entschlüsselung von Zertifikaten haben, stellen Sie sicher, dass Sie in der Umgebungsvariablen MATCH_PASSWORD die richtige Passphrase festgelegt haben.

  • Stellen Sie bei Problemen mit der Codesignatur sicher, dass Ihr Apple Developer-Konto über die erforderlichen Zertifikate und Profile verfügt und dass die Bundle-ID in Ihrem Xcode-Projekt mit der in Ihrem Bereitstellungsprofil übereinstimmt.

Sicherheitsüberlegungen

Im Folgenden finden Sie Sicherheitsüberlegungen für dieses Tutorial.

  • Halten Sie Ihr GitHub Repository für Zertifikate geheim und überprüfen Sie regelmäßig den Zugriff.

  • Erwägen Sie AWS Secrets Manager die Verwendung zum Speichern vertraulicher Informationen wie MATCH_PASSWORD und FASTLANE_SESSION.

Dieses Beispiel bietet eine Einrichtung für die iOS-Codesignatur, bei der Fastlane für die Zertifikatsspeicherung verwendet wird. CodeBuild GitHub Möglicherweise müssen Sie einige Schritte an Ihre spezifischen Projektanforderungen und Ihre CodeBuild Umgebung anpassen. Dieser Ansatz nutzt AWS Dienste für mehr Sicherheit und Integration innerhalb des AWS Ökosystems.