Firmare il codice per iOS

In questo articolo, apprenderai come firmare il codice per iOS. Devi firmare la tua app per iOS se hai selezionato iOS come una delle piattaforme mentre crei e costruisci il tuo progetto di wrapping.

Importante

L'uso di Xcode per firmare digitalmente le tue app per dispositivi mobili di cui è stato eseguito il wrapping per iOS non è supportato. Segui le istruzioni riportate di seguito per firmare correttamente i pacchetti dell'app per dispositivi mobili di cui è stato eseguito il wrapping per iOS.

Prerequisiti

Per iniziare dovrai eseguire le seguenti operazioni:

  • ID app
  • UDID del dispositivo (solo a scopo di test e sviluppo)

Avrai anche bisogno di un dispositivo macOS per la firma del codice per iOS.

Preparare il Mac

Configura il tuo Mac con la seguente configurazione.

  1. Installa Xcode. Altre informazioni: Xcode
  2. Installa PowerShell per macOS. Altre informazioni; Installare PowerShell in macOS
  3. Iscriviti al Programma per sviluppatori Apple
  4. Per distribuire le tue app all'interno dell'organizzazione, devi registrarti al Programma per sviluppatori Apple Enterprise.

Creare l'ID app

  1. Accedi al tuo account sviluppatore andando su https://developer.apple.com e selezionando la scheda Account.

    Scheda Account.

  2. Vai a Certificati, ID e profili > Identificatori.

  3. Seleziona + per creare un nuovo identificatore.

    Crea un nuovo idenficatore.

  4. Seleziona ID app, quindi seleziona Continua.

    Registra un nuovo identificatore.

  5. Seleziona il tipo come App, quindi seleziona Continua.

  6. Registra un ID app:

    Registra un ID app.

    1. Descrizione - Nome della tua app.
    2. ID aggregazione - Seleziona ID aggregazione esplicito.
    3. Inserisci l'ID aggregazione che hai utilizzato durante la creazione del progetto di wrapping. Maggiori informazioni: ID aggregazione
    4. Abilita le seguenti funzionalità:
      • Domini associati
      • iCloud
      • Lettura tag NFC
      • Notifiche push
    5. Selezionare Continua.
  7. Esamina e registra l'ID app.

Creare un certificato di distribuzione

Per creare un certificato di distribuzione, crea prima una nuova richiesta di firma del certificato.

Creare la richiesta di firma del certificato (CSR)

  1. Sul tuo Mac, vai alla cartella Applicazioni > Utilità > apri Accesso Portachiavi.

  2. Seleziona Accesso portachiavi > Assistente certificato > Richiedi un certificato da un'autorità di certificazione.

    Richiedi un certificato da una CA.

  3. Compila le Informazioni sul certificato come spiegato di seguito, quindi seleziona Continua.

    1. Nel campo Indirizzo e-mail utente inserisci il tuo indirizzo e-mail ID Apple per identificarti con questo certificato.
    2. Nel campo Nome comune immetti il tuo nome.
    3. Nel gruppo Richiesta seleziona Salvato su disco.
    4. Salva il file nel tuo Mac.

Creare il certificato di distribuzione

  1. Accedi al tuo account sviluppatore in https://developer.apple.com selezionando la scheda Account.

  2. Vai a Certificati, ID e profili > Certificati.

    1. Seleziona + per creare un nuovo certificato.

    2. Seleziona App Store e Ad Hoc > Continua.

      Certificati, identificatori e profili

      Nota

      Se disponi di un account sviluppatore aziendale, avrai la possibilità di creare un certificato di distribuzione aziendale.

  3. Carica il file di richiesta di firma del certificato (CSR) che è stato generato nei passaggi precedenti.

    Carica il certificato.

  4. Seleziona Continua e scarica il certificato sul tuo Mac.

  5. Fai doppio clic sul file .cer scaricato per installarlo in Accesso Portachiavi.

  6. Prendu nota del Nome del certificato (di solito come Distribuzione iPhone: nome (ID team)). Questo valore è l'identità di firma del codice che deve essere fornita per la firma.

Aggiungere tutti i dispositivi in cui è necessario installare IPA

Nota

Questo passaggio è necessario solo se stai distribuendo l'app a utenti esterni. Non è necessario se l'app è solo per utenti interni.

  1. Accedi al tuo account sviluppatore in https://developer.apple.com selezionando la scheda Account.

  2. Vai a Certificati, ID e profili > Dispositivi.

  3. Seleziona + per registrare uno o più dispositivi.

  4. Inserisci il Nome dispositivo e l'ID dispositivo (UDID).

    Registra un dispositivo.

  5. Seleziona Salva.

    Suggerimento

    Puoi anche registrare più dispositivi insieme caricando un elenco di UDID.

Creare un profilo di provisioning iOS

  1. Accedi al tuo account sviluppatore andando su https://developer.apple.com e selezionando la scheda Account.

  2. Vai a Certificati, ID e profili > Profili.

  3. Seleziona + per creare un nuovo profilo.

  4. Seleziona Ad hoc > Continua.

    Ad Hoc.

    Nota

    A scopo di test di produzione e sviluppo, utilizza il metodo di distribuzione App Store.

  5. Seleziona l'ID app che hai creato in precedenza, quindi seleziona Continua.

    ID app.

  6. Seleziona il certificato che hai creato in precedenza, quindi seleziona Continua.

    Seleziona il certificato.

  7. Seleziona tutti i dispositivi di test in cui desideri installare l'app, quindi seleziona Continua.

    Aggiungi i dispositivi.

  8. Rivedi e assegna un nome al profilo di provisioning. Prendi nota del nome del profilo di provisioning.

  9. Genera e scarica il profilo sul tuo Mac.

  10. Fai doppio clic per aprire il file scaricato (*.mobileprovision) per registrarlo con Xcode.

Firmare l'archivio iOS

  1. Scarica e decomprimi il file iOS-Archive.zip da App Center. Questo crea una cartella con il nome di ID aggregazione. Nell'esempio seguente, l'ID aggregazione è com.single.wrap.

  2. Se firmi con un certificato aziendale, apri il file Distribution-exportOptions.plist con Xcode e modificare il valore per il campo metodo all'interno del file in impresa.

Nota

La firma aziendale non è supportata con la firma Key Vault.

  1. Apri il terminale e cambia la directory sulla cartella decompressa.

  2. Immetti pwsh per avviare PowerShell nel terminale.

  3. Esegui ./SignAndGenerateIPA.ps1 con i valori dei parametri "CodeSigningIdentity" e "ProvisioningProfilePath".

    Nota

    "CodeSigningIdentity" è il nome del certificato che è stato creato sul sito Web degli sviluppatori Apple. Per cercare il valore di "CodeSigningIdentity", fai clic con il pulsante destro del mouse sul file .mobileprovision (il profilo di provisioning), quindi seleziona Altre informazioni. Scorri verso il basso e seleziona Anteprima. Il valore "CodeSigningIdentity" è memorizzato nel campo Nome sotto Certificati nel file .mobileprovision.

    Suggerimento

    "ProvisioningProfilePath" è il percorso del file del profilo di provisioning che hai scaricato dal sito Web degli sviluppatori Apple nel passaggio precedente Creare un profilo di provisioning iOS. Ad esempio, potrebbe trovarsi in /Users/username/Downloads/MyProvisioningProfile.mobileprovision sul tuo computer.

    Esegui lo script PowerShell.

  4. Al termine dello script, un file .ipa viene creato come com.single.wrap.ipa.

    • Se il comando ./SignAndGenerateIPA.ps1 non riesce, quindi elimina la cartella e i file decompressi perché potrebbero essere danneggiati. Decomprimi iOS-Archive.zip di nuovo prima di provare a firmare nuovamente.

    Pacchetto IPA.

  5. Installa il file .ipa nei dispositivi registrati utilizzando l'app Finder. Puoi anche ospitarlo su un servizio di distribuzione come App Center. Per distribuire tramite Microsoft Intune, vedi Aggiungere un'app line-of-business per iOS/iPadOS a Microsoft Intune. Per informazioni su come concedere a un'app l'accesso al servizio Protezione app di Intune, vedi Concedere alla tua app l'accesso al servizio Protezione app di Intune.

Vedi anche