Setup iOS

Salin prompt setup yang berisi langkah install dan panduan markdown lengkap untuk plugin ini.

Matriks Dukungan iOS

Intune iOS SDK yang dibundel oleh plugin ini: 21.5.1
Versi iOS minimum: 17.0
Versi Xcode yang direkomendasikan: 26.x

Dokumentasi Intune dari Ionic saat ini mencatat bahwa aplikasi yang di-build dengan Xcode 26 harus menggunakan Intune iOS SDK 21.1.0+ mulai 19 Januari 2026. Plugin ini sudah menggunakan versi SDK terbaru tersebut.

1. Tambahkan pengaturan Intune dan MSAL ke `Info.plist`

Add an IntuneMAMSettings dictionary:

<key>IntuneMAMSettings</key>
<dict>
  <key>ADALClientId</key>
  <string>YOUR_CLIENT_ID</string>
  <key>ADALRedirectUri</key>
  <string>msauth.com.example.app://auth</string>
  <key>ADALAuthority</key>
  <string>https://login.microsoftonline.com/common</string>
</dict>

Plugin membaca:

ADALClientId
ADALRedirectUri
ADALRedirectScheme sebagai fallback jika Anda lebih suka hanya menyimpan scheme
ADALAuthority sebagai override otoritas opsional

2. Teruskan callback MSAL di `AppDelegate`

import MSAL

func application(
  _ app: UIApplication,
  open url: URL,
  options: [UIApplication.OpenURLOptionsKey: Any] = [:]
) -> Bool {
  return MSALPublicClientApplication.handleMSALResponse(
    url,
    sourceApplication: options[.sourceApplication] as? String
  )
}

3. Konfigurasi URL schemes dan entitlements

Ikuti panduan Intune dari Microsoft dan Ionic untuk:

halaman msauth... skema redirect URI
berbagi keychain / grup akses keychain
LSApplicationQueriesSchemes
NSFaceIDUsageDescription jika alur Anda memerlukan biometrik

Ini bersifat spesifik untuk aplikasi dan tidak dapat dideteksi oleh plugin.

4. Jalankan `IntuneMAMConfigurator`

Microsoft mewajibkan untuk menjalankan IntuneMAMConfigurator pada aplikasi final Anda Info.plist dan entitlements. Gunakan configurator terbaru dari resmi Intune iOS SDK dan jalankan ulang setiap kali file tersebut berubah secara signifikan.

5. Jaga keselarasan deployment target

Karena SDK Intune iOS yang dibundel ada pada 21.x line terbaru, target aplikasi Anda harus tetap di iOS 17.0 or later.

Lanjutkan dari iOS Setup

Jika Anda menggunakan Setup iOS untuk merencanakan pekerjaan plugin native, hubungkan dengan Menggunakan @capgo/capacitor-intune untuk kapabilitas native saat menggunakan @capgo/capacitor-intune, Direktori Plugin Capgo untuk alur kerja produk di Direktori Plugin Capgo, Plugin Capacitor oleh Capgo untuk detail implementasi pada Capacitor Plugins oleh Capgo Menambahkan atau Memperbarui Plugin untuk detail implementasi di Menambahkan atau Memperbarui Plugin, dan Alternatif Plugin Ionic Enterprise untuk alur kerja produk dalam Alternatif Plugin Ionic Enterprise.