Kompilasi Otomatis Capacitor iOS dengan Codemagic

Berikut adalah terjemahan teks tersebut ke dalam bahasa Indonesia:

Pengiriman Berkelanjutan untuk iOS menggunakan Codemagic

Prasyarat

Sebelum melanjutkan tutorial…

• Keanggotaan program pengembang iOS
• Keinginan untuk membaca 😆…

Penting tentang harga

https://codemagic.io/pricing/

Layanan ini ‘gratis’ hingga 500 menit macOS M1 / bulan, tergantung mesin yang dipilih Kita akan menggunakan mesin macOS M1, Anda dapat melihat harga dan batasannya di tangkapan layar (harga pada saat pembuatan tutorial, mungkin berubah di masa mendatang)

🔴 Setelah diperingatkan tentang persyaratan dan harga, jika Anda suka, kita lanjutkan…

📣 Dalam posting ini kami berasumsi bahwa kami telah membuat aplikasi di iTunes Connect, kami memiliki sertifikat dari ekosistem Apple, semuanya akan diatur oleh Codemagic!

Mari kita mulai 🧑🏽‍💻

Langkah-langkah yang akan diikuti dalam posting ini

1. Menggunakan App Store Connect API dengan Codemagic
2. Persyaratan
3. Membuat Kunci API App Store Connect
4. Menggunakan Kunci API App Store Connect
5. Menyalin file Fastlane
6. Mengonfigurasi Codemagic

1. Menggunakan App Store Connect API dengan Codemagic

Mulai Februari 2021, autentikasi dua faktor atau verifikasi dua langkah diperlukan untuk semua pengguna untuk masuk ke App Store Connect. Lapisan keamanan tambahan ini untuk Apple ID Anda membantu memastikan bahwa hanya Anda yang dapat mengakses akun Anda. Dari Dukungan Apple

Memulai dengan match mengharuskan Anda mencabut sertifikat yang ada. Tapi jangan khawatir, Anda akan langsung mendapatkan yang baru.

Persyaratan

Untuk dapat menggunakan App Store Connect API, Codemagic membutuhkan tiga hal

1. ID Penerbit
2. ID Kunci
3. File Kunci atau Konten Kunci

Membuat Kunci API App Store Connect

Untuk menghasilkan kunci, Anda harus memiliki izin Admin di App Store Connect. Jika Anda tidak memiliki izin tersebut, Anda dapat mengarahkan orang yang relevan ke artikel ini dan mengikuti instruksi berikut

1 — Masuk ke App Store Connect

2 — Pilih Pengguna dan Akses

3 — Pilih tab Kunci API

4 — Klik Hasilkan Kunci API atau tombol Tambah (+)

5 — Masukkan nama untuk kunci dan pilih tingkat akses. Kami merekomendasikan untuk memilih hak akses App Manager, baca lebih lanjut tentang izin peran Program Pengembang Apple di sini

6 — Klik Hasilkan

Akses kunci API tidak dapat dibatasi hanya untuk aplikasi tertentu

Nama kunci baru, ID kunci, tautan unduhan, dan informasi lainnya muncul di halaman

Dapatkan ketiga informasi yang diperlukan di sini: <1> ID Penerbit
<2> ID Kunci
<3> Klik “Unduh Kunci API” untuk mengunduh kunci pribadi API Anda. Tautan unduhan hanya muncul jika kunci pribadi belum diunduh. Apple tidak menyimpan salinan kunci pribadi. Jadi, Anda hanya dapat mengunduhnya sekali

🔴 Simpan kunci pribadi Anda di tempat yang aman. Anda tidak boleh membagikan kunci Anda, menyimpan kunci di repositori kode, atau menyertakan kunci dalam kode sisi klien

Menambahkan kunci API App Store Connect ke Codemagic

1. Buka pengaturan Tim Codemagic Anda, Pilih identitas penandatanganan kode Dan unggah sertifikat

2. Klik tombol Tambah kunci

3. Masukkan Nama kunci API App Store Connect. Ini adalah nama yang dapat dibaca manusia untuk kunci yang akan digunakan untuk merujuk kunci tersebut nanti dalam pengaturan aplikasi

4. Masukkan nilai ID Penerbit dan ID Kunci

5. Klik pada **PilihBerikut adalah terjemahan teks tersebut ke dalam bahasa Indonesia:

file p8** atau seret file untuk mengunggah kunci API App Store Connect yang telah diunduh sebelumnya 6. Klik Simpan

Sekarang kita dapat mengelola Codemagic dengan kunci API App Store Connect, bagus!

2. Membuat sertifikat dan profil penyediaan

Sertifikat

Buka XCode dan pergi ke Pengaturan > Akun > Apple ID > Tim dan pilih tim Anda

Klik pada Kelola sertifikat > + dan pilih Apple Distribution

Kemudian Anda dapat membuat sertifikat baru

Selanjutnya Anda perlu pergi ke keychain untuk mengunduh sertifikat sebagai file p12

Untuk melakukannya, Anda perlu pergi ke keychain beralih ke keychain login dan kemudian tab Sertifikat Saya

Kemudian Anda dapat memilih sertifikat yang ingin Anda unduh (Lihat berdasarkan tanggal sertifikat)

Dan kemudian klik kanan pada sertifikat dan pilih Ekspor

Pilih format file Personal Information Exchange (p12)

Itu akan mengunduh sertifikat sebagai file p12

Profil penyediaan

Buka Apple Developer dan pilih tim yang tepat

Kemudian buat profil baru, dengan mengklik +

Dan pilih App Store Connect

Kemudian Anda perlu memilih aplikasi yang tepat, berhati-hatilah Anda tidak dapat menggunakan wildcard karena penandatanganan akan gagal

Pilih sertifikat yang tepat yang Anda buat sebelumnya (cari tanggal kedaluwarsa, seharusnya sama dengan hari dan bulan hari ini) dan klik Lanjutkan

Akhirnya masukkan nama profil dan klik Buat

Nama tersebut akan digunakan untuk mengidentifikasi profil di Codemagic

Anda dapat mengunduh profil sebagai file mobileprovision

Menambahkan sertifikat penandatanganan kode

Codemagic memungkinkan Anda mengunggah sertifikat penandatanganan kode sebagai arsip PKCS#12 yang berisi sertifikat dan kunci pribadi yang diperlukan untuk menggunakannya. Saat mengunggah, Codemagic akan meminta Anda untuk memberikan kata sandi sertifikat (jika sertifikat dilindungi kata sandi) bersama dengan Nama referensi yang unik, yang kemudian dapat digunakan dalam konfigurasi codemagic.yml untuk mengambil file tertentu

• Unggah sertifikat
• Buat sertifikat baru
• Ambil dari Portal Pengembang

1. Buka pengaturan Tim Codemagic Anda, pergi ke pengaturan codemagic.yml > Identitas penandatanganan kode
2. Buka tab Sertifikat iOS
3. Unggah file sertifikat dengan mengklik Pilih file p12 atau pem atau dengan menyeretnya ke dalam bingkai yang ditunjukkan
4. Masukkan Kata sandi sertifikat dan pilih Nama referensi
5. Klik Tambah sertifikat

Menambahkan profil penyediaan

Codemagic memungkinkan Anda mengunggah profil penyediaan untuk digunakan untuk aplikasi atau mengambil profil dari Portal Pengembang Apple

Jenis profil, tim, id bundle, dan tanggal kedaluwarsa ditampilkan untuk setiap profil yang ditambahkan ke Identitas penandatanganan kode. Selanjutnya, Codemagic akan memberi tahu Anda apakah sertifikat penandatanganan kode yang sesuai tersedia di Identitas penandatanganan kode (tanda centang hijau di kolom Sertifikat) atau tidak

3. Menyiapkan Codemagic

Mengonfigurasi rahasia Codemagic

Pernah bertanya-tanya dari mana nilai ENV berasal? Yah, itu bukan rahasia lagi - itu berasal dari rahasia proyek Anda 🤦

4. Mengonfigurasi file alur kerja Codemagic

Buat file bernama codemagic.yml di root proyek Anda dan tambahkan yang berikut

workflows:
  ionic-capacitor-ios-workflow:
    name: Capacitor iOS Workflow
    max_build_duration: 120
    instance_type: mac_mini_m1
    integrations:
      app_store_connect: CodeMagic
    environment:
      ios_signing:
        distribution_type: app_store
        bundle_identifier: YOUR_BUNDLE_IDENTIFIER
      vars:
        XCODE_WORKSPACE: ios/App/App.xcworkspace
        XCODE_SCHEME: App
        APP_STORE_APP_ID: YOUR_APP_STORE_APP_ID
      node: v20.14.0
      xcode: 15.4
      cocoapods: default
    triggering:
      events:
        - tag
      tag_patterns:
        - pattern: '*'
          include: true
    scripts:
      - name: Install dependencies
        script: |
          npm install
      - name: Cocoapods installation
        script: |
          cd ios/App && pod install
      - name: Update dependencies and copy web assets to native project
        script: |
          npm run build
          npx cap sync ios
      - name: Set up code signing settings on Xcode project
        script: |
          xcode-project use-profiles
      - name: Increment build number
        script: |
          cd $CM_BUILD_DIR/ios/App
          LATEST_BUILD_NUMBER=$(app-store-connect get-latest-app-store-build-number "$APP_ID")
          agvtool new-version -all $(($LATEST_BUILD_NUMBER + 1))
      - name: Build ipa for distribution
        script: |
          xcode-project build-ipa \
            --workspace "$XCODE_WORKSPACE" \
            --scheme "$XCODE_SCHEME"
    artifacts:
      - build/ios/ipa/*.ipa
      - /tmp/xcodebuild_logs/*.log
      - $HOME/Library/Developer/Xcode/DerivedData/**/Build/**/*.app
      - $HOME/Library/Developer/Xcode/DerivedData/**/Build/**/*.dSYM
    publishing:
      email:
        recipients:
          - YOUR_EMAIL
        notify:
          success: true # To not receive a notification when a build succeeds
          failure: false # To not receive a notification when a build fails
      app_store_connect:
        auth: integration
        # Configuration related to TestFlight (optional)
        # Note: This action is performed during post-processing.
        submit_to_testflight: true
        # Configuration related to App Store (optional)
        # Note: This action is performed during post-processing.
        submit_to_app_store: false

Alur kerja ini harus dipicu secara manual atau setelah setiap tag GitHub, jika Anda perlu mengotomatisasi tag, silakan lihat Pembangunan dan rilis otomatis dengan tindakan GitHub terlebih dahuluKemudian alur kerja ini akan mengambil dependensi NodeJS Anda, menginstalnya, dan membangun aplikasi JavaScript Anda

Setiap kali Anda mengirim tag baru, sebuah rilis akan dibangun di TestFlight

Aplikasi Anda tidak perlu menggunakan Ionic, hanya basis Capacitor yang wajib, dapat memiliki modul Cordova lama, tetapi plugin Capacitor JS lebih diutamakan

5. Memicu alur kerja

Memicu alur kerja

Dorong commit baru ke cabang main atau developement untuk memicu alur kerja

Setelah beberapa menit, build seharusnya tersedia di dasbor App Store Connect Anda

Memulai secara manual

Anda dapat memulai alur kerja secara manual

Pertama pilih aplikasi yang ingin Anda bangun, lalu klik Mulai build baru

Kemudian pilih cabang yang ingin Anda bangun

Dan klik Mulai build baru

Kemudian pergi ke daftar build

Dan klik pada build untuk melihat hasilnya

Dapat mendeploy dari mesin lokal

Ya, Anda bisa, dan itu sangat mudah

Anda dapat menggunakan Xcode untuk membangun dan menandatangani aplikasi Anda, seperti biasa

Terima kasih

Blog ini berdasarkan artikel-artikel berikut:

• Pengiriman berkelanjutan untuk IOS menggunakan Codemagic dan GitHub actions
• Dokumentasi Codemagic
• Pesan GitHub ini dari @mrogunlana