View a markdown version of this page

Tutorial: Penandatanganan kode Apple dengan Fastlane dalam CodeBuild penggunaan GitHub untuk penyimpanan sertifikat - AWS CodeBuild
PrasyaratLangkah 1: Siapkan Fastlane Match dengan GitHub pada mesin lokal AndaLangkah 2: Siapkan Fastfile AndaLangkah 3: Jalankan perintah fastlane match untuk menghasilkan sertifikat dan profil masing-masingLangkah 4: Buat file aplikasi untuk proyek AndaLangkah 5: Buat variabel lingkungan di Manajer RahasiaLangkah 6: Buat armada komputasiLangkah 7: Buat proyek di CodeBuildLangkah 8: Jalankan buildPemecahan masalahPertimbangan keamanan

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Tutorial: Penandatanganan kode Apple dengan Fastlane dalam CodeBuild penggunaan GitHub untuk penyimpanan sertifikat

fastlane adalah alat otomatisasi sumber terbuka yang populer untuk mengotomatiskan penerapan dan rilis beta untuk aplikasi iOS dan Android Anda. Ini menangani semua tugas yang membosankan, seperti membuat tangkapan layar, menangani penandatanganan kode, dan merilis aplikasi Anda.

Contoh ini menunjukkan cara mengatur penandatanganan kode Apple menggunakan Fastlane dalam CodeBuild proyek yang berjalan di armada Mac, dengan GitHub sebagai penyimpanan untuk sertifikat dan profil penyediaan.

Prasyarat

Untuk menyelesaikan tutorial ini, Anda harus terlebih dahulu menyiapkan yang berikut:

  • Sebuah Akun AWS

  • Akun Pengembang Apple

  • GitHub Repositori pribadi untuk menyimpan sertifikat

  • fastlane diinstal di proyek Anda - Panduan untuk menginstal fastlane

Langkah 1: Siapkan Fastlane Match dengan GitHub pada mesin lokal Anda

Fastlane Match adalah salah satu alat Fastlane, dan memungkinkan konfigurasi yang mulus untuk penandatanganan kode di lingkungan pengembangan lokal Anda dan seterusnya. CodeBuild Fastlane Match menyimpan semua sertifikat penandatanganan kode dan profil penyediaan Anda di Git repository/S3 Bucket/Google Cloud Storage, dan mengunduh serta menginstal sertifikat dan profil yang diperlukan bila diperlukan.

Dalam contoh konfigurasi ini, kita akan mengatur dan menggunakan repositori Git untuk penyimpanan.

  1. Inisialisasi kecocokan dalam proyek Anda:

    fastlane match init

  2. Saat diminta, pilih GitHub sebagai mode penyimpanan.

  3. Perbarui `Matchfile` Anda untuk digunakan 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
catatan

Pastikan Anda memasukkan URL HTTPS untuk repositori Git Anda agar fastlane berhasil mengotentikasi dan mengkloning. Jika tidak, Anda mungkin melihat kesalahan otentikasi saat mencoba menggunakan kecocokan.

Langkah 2: Siapkan Fastfile Anda

Buat atau perbarui `Fastfile` Anda dengan jalur berikut.

Pada CodeBuild, Fastlane Match harus dijalankan setiap kali Anda membuat dan menandatangani aplikasi Anda. Cara termudah untuk melakukannya adalah dengan menambahkan match tindakan ke jalur yang membangun aplikasi Anda.

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
catatan

Pastikan untuk menambahkan setup_ci ke before_all bagian Fastfile agar tindakan pertandingan berfungsi dengan benar. Ini memastikan bahwa gantungan kunci Fastlane sementara dengan izin yang sesuai digunakan. Tanpa menggunakan ini, Anda mungkin melihat kegagalan build atau hasil yang tidak konsisten.

Langkah 3: Jalankan perintah fastlane match untuk menghasilkan sertifikat dan profil masing-masing

Perintah fastlane match untuk tipe yang diberikan (yaitu development, appstore, adhoc, enterprise) akan menghasilkan sertifikat dan profil jika tidak tersedia di remote store. Sertifikat dan profil akan disimpan GitHub oleh fastlane.

bundle exec fastlane match appstore

Eksekusi perintah akan interaktif dan fastlane akan meminta untuk mengatur frase sandi untuk mendekripsi sertifikat.

Langkah 4: Buat file aplikasi untuk proyek Anda

Buat atau tambahkan file aplikasi yang sesuai untuk proyek Anda.

  1. Buat atau tambahkan Gymfile, Appfile, Snapfile , Deliverfile berdasarkan persyaratan pembuatan proyek Anda.

  2. Lakukan perubahan ke repositori jarak jauh Anda.

Langkah 5: Buat variabel lingkungan di Manajer Rahasia

Buat tiga rahasia untuk menyimpan cookie sesi fastlane dan frase sandi yang cocok. Untuk informasi selengkapnya tentang membuat rahasia di Manajer Rahasia, lihat Membuat AWS Secrets Manager rahasia.

  1. Akses cookie sesi fastlane Anda sebagai berikut.

    1. Kunci rahasia - FASTLANE_SESSION

    2. Nilai rahasia - cookie sesi yang dihasilkan dari menjalankan perintah berikut pada mesin lokal Anda.

      catatan

      Nilai ini tersedia setelah otentikasi dalam file lokal:~/.fastlane/spaceship/my_appleid_username/cookie.

      fastlane spaceauth -u <Apple_account>

  2. Frasa sandi Fastlane Match - Untuk mengaktifkan Fastlane Match untuk mendekripsi sertifikat dan profil yang disimpan di repositori Git, Anda perlu menambahkan frasa sandi enkripsi yang Anda konfigurasikan pada langkah pengaturan Cocokkan ke variabel lingkungan proyek. CodeBuild

    1. Kunci rahasia - MATCH_PASSWORD

    2. Nilai rahasia -<match passphrase to decrypt certificates>. Frasa sandi disetel saat membuat sertifikat di Langkah 3.

  3. Fastlane MATCH_GIT_BASIC_AUTHORIZATION - mengatur otorisasi dasar untuk pertandingan:

    1. Kunci rahasia:

      MATCH_GIT_BASIC_AUTHORIZATION

    2. Nilai rahasia - Nilai harus berupa string yang dikodekan base64 dari nama pengguna dan token akses pribadi (PAT) Anda dalam formatusername:password. Anda dapat menghasilkannya menggunakan perintah berikut:

      echo -n your_github_username:your_personal_access_token | base64

      Anda dapat membuat PAT di GitHub konsol di Profil Anda> Peng aturan> Pengaturan Pengembang> Token Akses Pribadi. Untuk informasi lebih lanjut, lihat panduan berikut: https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens.

catatan

Saat membuat rahasia di atas di Secrets Manager, ingatlah untuk memberikan nama rahasia dengan awalan berikut: /CodeBuild/

Langkah 6: Buat armada komputasi

Buat armada komputasi untuk proyek Anda.

  1. Di konsol, buka CodeBuild dan buat armada komputasi baru.

  2. Pilih macOS sebagai sistem operasi dan pilih jenis dan gambar komputasi yang sesuai.

Langkah 7: Buat proyek di CodeBuild

Buat proyek Anda di CodeBuild.

  1. Buka AWS CodeBuild konsol di https://console.aws.amazon.com/codesuite/codebuild/home.

  2. Buat proyek pembangunan. Untuk informasi selengkapnya, lihat Membuat proyek build (konsol) dan Jalankan build (konsol).

  3. Siapkan penyedia sumber Anda (seperti GitHub, CodeCommit). Ini adalah repositori sumber proyek iOS dan bukan repositori sertifikat.

  4. Di Lingkungan:

    • Pilih Kapas itas Cadangan.

    • Untuk Ar mada, pilih armada yang dibuat di atas.

    • Berikan nama peran layanan yang CodeBuild akan dibuat untuk Anda.

    • Berikan variabel lingkungan di bawah ini.

      • Nama:MATCH_PASSWORD, Nilai:<secrets arn>, Jenis: Manajer Rahasia (Rahasia ARN dibuat pada langkah 5 untuk MATCH_PASSWORD)

      • Nama:FASTLANE_SESSION, Nilai:<secrets arn>, Jenis: Manajer Rahasia (Rahasia ARN dibuat pada langkah 5 untuk FASTLANE_SESSION)

      • Nama:MATCH_GIT_BASIC_AUTHORIZATION, Nilai:<secrets ARN>, Jenis: Rahasia Manajer Rahasia ARN (dibuat pada langkah 5 untukMATCH_GIT_BASIC_AUTHORIZATION)

  5. Di Buildspec, tambahkan yang berikut ini:

    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)

Langkah 8: Jalankan build

Jalankan build. Anda dapat meninjau status build dan log in CodeBuild.

Setelah pekerjaan selesai, Anda akan dapat melihat log pekerjaan.

Pemecahan masalah

  • Jika Anda mengalami masalah saat mengakses GitHub repositori, periksa kembali token akses pribadi Anda dan variabel lingkungan MATCH_GIT_BASIC_AUTHORIZATION.

  • Jika Anda mengalami masalah dengan dekripsi sertifikat, pastikan Anda menetapkan frasa sandi yang benar di variabel lingkungan MATCH_PASSWORD.

  • Untuk masalah penandatanganan kode, verifikasi bahwa akun Pengembang Apple Anda memiliki sertifikat dan profil yang diperlukan, dan bahwa pengenal bundel di proyek Xcode Anda cocok dengan yang ada di profil penyediaan Anda.

Pertimbangan keamanan

Berikut ini adalah pertimbangan keamanan untuk tutorial ini.

  • Jaga GitHub repositori Anda untuk sertifikat pribadi dan secara teratur mengaudit akses.

  • Pertimbangkan AWS Secrets Manager untuk menggunakan untuk menyimpan informasi sensitif seperti MATCH_PASSWORD dan FASTLANE_SESSION.

Contoh ini menyediakan pengaturan untuk penandatanganan kode iOS dengan Fastlane dalam CodeBuild penggunaan GitHub untuk penyimpanan sertifikat. Anda mungkin perlu menyesuaikan beberapa langkah berdasarkan persyaratan dan CodeBuild lingkungan proyek spesifik Anda. Pendekatan ini memanfaatkan AWS layanan untuk meningkatkan keamanan dan integrasi dalam AWS ekosistem.