React Native Academy · Pelajaran

Mengkonfigurasi Penandatanganan dengan EAS Build

Sediakan eas.json dengan profil binaan pengeluaran, jalankan eas credentials untuk mengurus sijil, dan cetuskan EAS Build yang menghasilkan fail .ipa bertanda tangan.

Pelajaran 2 daripada 413 langkah

Mengkonfigurasi Penandatanganan dengan EAS Build ialah pelajaran React Native Academy percuma di CoddyKit. Ini ialah pelajaran 2 daripada 4. Sebanyak 3 pelajaran dalam laluan pembelajaran ini boleh dibaca sepenuhnya secara percuma — selepas itu, CoddyKit PRO membuka akses kepada semua pelajaran, serta latihan praktikal dengan penyunting kod terbina dalam dan tutor kecerdasan buatan yang tersedia 24/7. Pelajaran ini merupakan sebahagian daripada laluan pembelajaran React Native Academy, dan kemajuan anda disegerakkan merentas web serta aplikasi CoddyKit. Kursus React Native Academy merangkumi sejumlah 4 pelajaran.

Apakah EAS Build

EAS Build (Expo Application Services Build) ialah perkhidmatan binaan awan yang menyusun aplikasi React Native atau Expo anda pada infrastruktur Expo, lalu menghasilkan .ipa yang ditandatangani untuk iOS atau .apk/.aab untuk Android. Anda tidak memerlukan Xcode, Android Studio atau Mac untuk binaan iOS — EAS menyediakan mesin macOS terurus. EAS juga mengendalikan kelayakan penandatanganan kod secara automatik.

Memasang dan Log Masuk ke EAS CLI

EAS CLI ialah alat baris perintah yang anda gunakan untuk mencetuskan binaan, mengurus kelayakan dan menghantar aplikasi. Pasangnya secara global dengan npm, kemudian log masuk menggunakan akaun Expo anda. Anda memerlukan akaun Expo (percuma) selain akaun Apple Developer. Selepas log masuk, EAS boleh berkomunikasi dengan API Apple bagi pihak anda untuk mengurus sijil dan profil peruntukan.

# Install EAS CLI globally
npm install -g eas-cli

# Verify installation
eas --version

# Log in with your Expo account
eas login

# Check who you are logged in as
eas whoami

# Link your project (run from project root)
eas init

Fail Konfigurasi eas.json

Semua tingkah laku EAS Build dikonfigurasikan dalam eas.json di akar projek. Anda mentakrifkan profil binaan — konfigurasi bernama seperti development, preview dan production. Setiap profil menentukan jenis pengedaran, sumber kelayakan, pemboleh ubah persekitaran dan tetapan khusus platform. Jalankan eas build:configure untuk menjana eas.json awal secara automatik.

// eas.json
{
  'cli': { 'version': '>= 5.0.0' },
  'build': {
    'development': {
      'developmentClient': true,
      'distribution': 'internal',
      'ios': { 'simulator': true }
    },
    'preview': {
      'distribution': 'internal'
    },
    'production': {
      'distribution': 'store',
      'credentialsSource': 'remote'
    }
  },
  'submit': {
    'production': {
      'ios': { 'appleId': 'you@example.com' }
    }
  }
}

Menyediakan Kelayakan Secara Automatik

EAS boleh menyediakan semua kelayakan penandatanganan iOS secara automatik jika anda memberikannya akses kepada akaun Apple Developer anda. Apabila anda menjalankan eas build --platform ios buat kali pertama, EAS akan bertanya kepada anda: jana sijil dan profil peruntukan baharu, atau gunakan yang sedia ada. Pilih pilihan jana secara automatik, lalu EAS akan mencipta sijil pengedaran melalui API Apple, menjana profil peruntukan yang sepadan dan menyimpan kedua-duanya dengan selamat dalam stor kelayakan EAS.

# Trigger a production iOS build
eas build --platform ios --profile production

# EAS prompts:
# ? Would you like to log in to your Apple account?
# > Yes
# Enter Apple ID: you@example.com
# Enter password: (app-specific password)
#
# ? Generate a new Apple Distribution Certificate?
# > Generate a new certificate  <- choose this
#
# ? Generate a new Provisioning Profile?
# > Generate a new profile  <- choose this
#
# Build queued...

Melihat dan Mengurus Kelayakan

Perintah eas credentials membuka menu interaktif untuk melihat, mengemas kini atau membuang kelayakan yang disimpan. Anda boleh melihat tarikh tamat tempoh sijil, jenis profil peruntukan dan ID Aplikasi yang diliputinya. Anda juga boleh mendapatkan kelayakan daripada awan untuk digunakan secara setempat, atau menghantar .p12 dan .mobileprovision yang dijana secara setempat ke EAS jika anda lebih suka menguruskannya sendiri.

# View all stored credentials
eas credentials

# Select:
# Platform: iOS
# App: com.yourcompany.myapp
#
# EAS shows:
# Distribution Certificate
#   - Issued to: Your Name
#   - Expires: Dec 15, 2026
#   - Serial: A1B2C3...
# Provisioning Profile
#   - Type: App Store
#   - Expires: Dec 15, 2026
#   - Profile UUID: XXXXXXXXX

Pemboleh Ubah Persekitaran dalam EAS Build

EAS Build menyokong pemboleh ubah persekitaran untuk rahsia dan konfigurasi semasa binaan. Takrifkannya dalam eas.json di bawah kunci env untuk profil tertentu, atau simpan nilai sensitif dalam EAS Secrets melalui eas secret:create. EAS Secrets disulitkan dan hanya disuntik ke dalam binaan — rahsia tersebut tidak pernah direkodkan atau didedahkan kepada umum. Gunakannya untuk kunci API, token atau apa-apa nilai yang tidak boleh dimasukkan ke dalam kawalan sumber.

// eas.json — environment variables per profile
{
  'build': {
    'production': {
      'distribution': 'store',
      'env': {
        'EXPO_PUBLIC_API_URL': 'https://api.yourapp.com',
        'APP_VARIANT': 'production'
      }
    },
    'preview': {
      'env': {
        'EXPO_PUBLIC_API_URL': 'https://staging.yourapp.com',
        'APP_VARIANT': 'staging'
      }
    }
  }
}

// Add secrets (sensitive values NOT in eas.json)
// eas secret:create --scope project --name STRIPE_SECRET_KEY --value sk_live_...

Mencetuskan Binaan dan Memantau Kemajuan

Mulakan binaan iOS pengeluaran dengan eas build --platform ios --profile production. EAS akan memasukkan binaan ke dalam baris gilir pada pelaksana macOS dan memberikan URL binaan yang boleh anda pantau dalam pelayar. Log binaan distrim dalam masa nyata. Status binaan bergerak melalui: beratur → sedang berjalan → selesai. Binaan yang selesai menghasilkan URL muat turun untuk .ipa atau muat naik TestFlight secara automatik jika dikonfigurasikan.

# Build and submit to TestFlight in one command
eas build --platform ios --profile production --auto-submit

# Or build first, submit separately
eas build --platform ios --profile production

# View recent builds
eas build:list

# View build logs for a specific build
eas build:view <build-id>

Binaan EAS Setempat untuk Penyahpepijatan

Jika binaan awan gagal dan anda tidak dapat mendiagnosis masalah berdasarkan log, jalankan binaan EAS setempat dengan eas build --local. Proses ini menjalankan proses binaan yang sama tepat pada Mac anda menggunakan langkah yang sama seperti pelaksana awan. Anda mendapat akses penuh kepada fail perantaraan dan boleh memasukkan langkah penyahpepijatan. Binaan setempat memerlukan Xcode yang dipasang, tetapi menggunakan skrip penyelarasan binaan EAS.

# Run the EAS build locally on your Mac
eas build --platform ios --profile production --local

# The build output is placed in:
# ./build-*.ipa (in the project root)

# Useful flags:
# --no-wait     (don't stream output, just start)
# --clear-cache (ignore previous build cache)

Penandatanganan Aliran Kerja Terurus berbanding Tanpa Abstraksi

Dalam aliran kerja terurus (Expo), EAS mengendalikan semua butiran penandatanganan asli — anda hanya perlu mengkonfigurasi eas.json. Dalam aliran kerja tanpa abstraksi (React Native yang dikeluarkan daripada Expo), anda masih boleh menggunakan EAS Build tetapi anda sendiri mengurus projek asli. EAS masih mengendalikan pengurusan kelayakan dan penyusunan dalam awan, tetapi anda mungkin perlu mengkonfigurasi tetapan penandatanganan projek Xcode secara manual melalui pemalam konfigurasi atau terus dalam ios/.

// eas.json — bare workflow needs explicit scheme
{
  'build': {
    'production': {
      'distribution': 'store',
      'ios': {
        'scheme': 'MyApp',  // Xcode scheme name
        'buildConfiguration': 'Release'
      }
    }
  }
}

Pengedaran Ad Hoc untuk Penguji QA

Pengedaran Ad Hoc membolehkan anda memasang binaan secara terus pada sehingga 100 peranti berdaftar tertentu tanpa melalui App Store atau TestFlight. Daftarkan UDID peranti penguji dalam Portal Pembangun, cipta profil peruntukan Ad Hoc, bina dengan distribution: 'internal' dalam EAS, kemudian kongsikan pautan pemasangan. EAS juga boleh mendaftarkan UDID peranti baharu untuk pasukan anda melalui perintah eas device:create.

// eas.json — internal/ad-hoc build
{
  'build': {
    'qa': {
      'distribution': 'internal',
      'ios': { 'simulator': false }
    }
  }
}

# Register a tester's device
eas device:create

# Build for QA (generates ad-hoc signed .ipa)
eas build --platform ios --profile qa

# Share the install link from the EAS dashboard with testers

Menyelesaikan Masalah Kegagalan Penandatanganan

Kegagalan penandatanganan yang biasa termasuk: ketidakpadanan sijil (sijil yang disimpan tidak sepadan dengan profil peruntukan — baiki dengan menjana semula kedua-duanya), sijil tamat tempoh (perbaharui melalui eas credentials), kelayakan yang hilang (keupayaan terdapat dalam fail kelayakan tetapi tiada dalam profil peruntukan — tambah keupayaan tersebut dalam Portal Pembangun dan jana semula profil), serta ID himpunan yang salah (semak semula bahawa ios.bundleIdentifier dalam app.json sepadan tepat dengan ID Aplikasi).

# Common fix: clear and regenerate credentials
eas credentials --platform ios
# Select: Remove all credentials, then run build again

# Or manually force new certificate:
eas credentials --platform ios
# Select: Update Distribution Certificate

# Check bundle ID mismatch
cat app.json | grep bundleIdentifier
# Should match exactly what's in developer.apple.com > Identifiers

Semakan Pantas

Uji pemahaman anda tentang konsep Pembangunan Mudah Alih React Native daripada pelajaran ini.

Jawab dalam pelajaran interaktif

Ringkasan Pelajaran

Dalam pelajaran ini, anda telah mempelajari: cara mengkonfigurasi eas.json dengan profil binaan untuk pembangunan, pratonton dan pengeluaran, cara EAS mengurus sijil iOS dan profil peruntukan secara automatik, serta cara menggunakan pemboleh ubah persekitaran dan EAS Secrets untuk konfigurasi semasa binaan. Anda juga telah melihat cara mencetuskan binaan, menjalankannya secara setempat untuk penyahpepijatan dan menyelesaikan masalah kegagalan penandatanganan yang biasa. Seterusnya, kita akan menyediakan metadata App Store dalam App Store Connect.

Percuma untuk bermula

Pelajari JavaScript dengan tutor kecerdasan buatan — percuma

Tulis dan jalankan kod sebenar dalam pelayar anda, dapatkan bantuan segera daripada tutor kecerdasan buatan yang tersedia 24/7, dan sambung semula dari tempat anda berhenti di web atau dalam aplikasi.

Kursus: 30
Pelajaran: 120

Mula belajar secara percuma Lihat kursus penuh

Soalan Lazim

Adakah pelajaran “Mengkonfigurasi Penandatanganan dengan EAS Build” percuma?

Ya — sebanyak 3 pelajaran dalam laluan pembelajaran React Native Academy, termasuk “Mengkonfigurasi Penandatanganan dengan EAS Build”, boleh dibaca sepenuhnya secara percuma di web ini. Selepas itu, CoddyKit PRO membuka akses kepada semua pelajaran, serta latihan interaktif dengan penyunting kod terbina dalam dan tutor kecerdasan buatan yang tersedia 24/7. Kursus React Native Academy merangkumi sejumlah 4 pelajaran.

Apakah yang akan saya pelajari dalam “Mengkonfigurasi Penandatanganan dengan EAS Build”?

Sediakan eas.json dengan profil binaan pengeluaran, jalankan eas credentials untuk mengurus sijil, dan cetuskan EAS Build yang menghasilkan fail .ipa bertanda tangan. Anda berlatih React Native Academy menggunakan kod praktikal yang dijalankan terus dalam pelayar, manakala tutor kecerdasan buatan 24/7 menjawab soalan anda semasa anda mengikuti pelajaran.

Adakah saya memerlukan pengalaman untuk memulakan React Native Academy?

Tiada pengalaman terdahulu diperlukan. Pembelajaran React Native Academy di CoddyKit disusun untuk pelajar daripada peringkat pemula hingga lanjutan, jadi anda boleh bermula di sini atau dari awal dan belajar mengikut kadar anda sendiri. Ini ialah pelajaran 2 daripada 4.

Berapa lamakah pelajaran “Mengkonfigurasi Penandatanganan dengan EAS Build” diambil?

Kebanyakan pelajaran CoddyKit mengambil masa kira-kira 5–10 minit. Setiap pelajaran ringkas dan interaktif, jadi anda boleh membuat kemajuan secara berterusan dan menyambung tepat dari tempat anda berhenti di web atau aplikasi.

Bolehkah saya menulis dan menjalankan kod dalam pelajaran React Native Academy ini?

Ya. Setiap pelajaran React Native Academy menyertakan penyunting kod terbina dalam, jadi anda boleh menulis dan menjalankan kod sebenar terus dalam pelayar serta menerima maklum balas kecerdasan buatan serta-merta — tanpa memerlukan persediaan setempat.

Semua pelajaran dalam kursus ini

Menyediakan Akaun Pembangun Apple dan Sijil
Mengkonfigurasi Penandatanganan dengan EAS Build
Menyediakan Metadata App Store dalam App Store Connect
Menghantar untuk Semakan dan Menjawab Penolakan

← Kembali ke React Native Academy