Firmare il codice manuale per iOS

2025-06-25

Questo articolo spiega come eseguire la firma del 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.

Operazioni preliminari

Prerequisiti

Prima di iniziare, verifica di disporre di:

ID app
UDID del dispositivo (solo a scopi di test e sviluppo)
Un dispositivo macOS per cui firmare il codice iOS

Configurare il Mac

Installa Xcode. Altre informazioni: Xcode
Installa PowerShell per macOS. Altre informazioni; Installare PowerShell in macOS
Iscriviti al Programma per sviluppatori Apple
Per la distriuzione delle organizzazioni, devi registrarti al Programma per sviluppatori Apple Enterprise

Creare l'ID app

Accedi al tuo account sviluppatore in https://developer.apple.com e seleziona la scheda Account.
Vai a Certificati, ID e profili > Identificatori.
Seleziona + per creare un nuovo identificatore.
Seleziona ID app, quindi seleziona Continua.
Seleziona il tipo come App, quindi seleziona Continua.
Registra un ID app:
- Descrizione - Nome della tua app.
- ID aggregazione: seleziona ID aggregazione esplicito.
- Inserisci l'ID aggregazione che hai utilizzato durante la creazione del progetto di wrapping. Maggiori informazioni: ID aggregazione
- Abilitare queste funzionalità:
  - Domini associati
  - iCloud
  - Lettura tag NFC
  - Notifiche push
- Seleziona Continua.
Esamina e registra l'ID app.

Creare un certificato di distribuzione

Creare la richiesta di firma del certificato (CSR)

Sul tuo Mac, vai alla cartella Applicazioni>Utilità> apri Accesso Portachiavi.
Seleziona Accesso portachiavi>Assistente certificato>Richiedi un certificato da un'autorità di certificazione.
Compila le informazioni sul certificato:
- Nel campo Indirizzo e-mail utente immettere l'indirizzo e-mail dell'ID Apple.
- Nel campo Nome comune immetti il tuo nome.
- Nel gruppo Richiesta seleziona Salvato su disco.
- Salva il file nel tuo Mac.
- Seleziona Continua.

Carica e installare il certificato

Accedi al tuo account sviluppatore in https://developer.apple.com selezionando la scheda Account.
Vai a Certificati, ID e profili > Certificati.
Seleziona + per creare un nuovo certificato.
Seleziona App Store e Ad Hoc>Continua.

Nota

Se disponi di un account sviluppatore aziendale, avrai la possibilità di creare un certificato di distribuzione aziendale.
Carica il file di richiesta di firma del certificato (CSR) che è stato generato nei passaggi precedenti.
Seleziona Continua e scarica il certificato sul tuo Mac.
Fai doppio clic sul file .cer scaricato per installarlo in Accesso Portachiavi.
Prendi nota del Nome del certificato (di solito in formato Distribuzione iPhone: nome (ID team)). Questo valore è l'identità di firma del codice necessaria per la firma.

Registrare i dispositivi per il test

Nota

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

Accedi al tuo account sviluppatore in https://developer.apple.com selezionando la scheda Account.
Vai a Certificati, ID e profili > Dispositivi.
Seleziona + per registrare uno o più dispositivi.
Inserisci il Nome dispositivo e l'ID dispositivo (UDID).
Selezionare Salva.

Suggerimento

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

Creare un profilo di provisioning iOS

Accedi al tuo account sviluppatore in https://developer.apple.com e seleziona la scheda Account.
Vai a Certificati, ID e profili > Profili.
Seleziona + per creare un nuovo profilo.
Seleziona Ad hoc>Continua.

Nota

A scopo di produzione, seleziona il metodo di distribuzione App Store.
Seleziona l'ID app che hai creato in precedenza, quindi seleziona Continua.
Seleziona il certificato che hai creato in precedenza, quindi seleziona Continua.
Seleziona tutti i dispositivi di test in cui desideri installare l'app, quindi seleziona Continua.
Assegna un nome al profilo di provisioning e prendine nota.
Seleziona Genera e scarica il profilo sul tuo Mac.
Fai doppio clic sul file scaricato (*.mobileprovision) per registrarlo con Xcode.

Firmare l'archivio iOS

Scarica e decomprimi il file iOS-Archive.zip da Archiviazione BLOB di Azure. Questo crea una cartella con il nome di ID aggregazione. Nell'esempio seguente, l'ID aggregazione è com.single.wrap.
Solo per la firma aziendale: apri il file Distribution-exportOptions.plist con Xcode e modificare il valore per il campo del metodo in enterprise.

Nota

La firma aziendale non è supportata con la firma Key Vault.
Apri il terminale e cambia la directory sulla cartella decompressa.
Immetti pwsh per avviare PowerShell nel terminale.
Eseguire lo script PowerShell con le informazioni del certificato e del profilo di provisioning:
```
./SignAndGenerateIPA.ps1 -CodeSigningIdentity "YOUR_CODE_SIGNING_IDENTITY" -ProvisioningProfilePath "PATH_TO_PROVISIONING_PROFILE"
```
Nota

Per trovare il valore CodeSigningIdentity, fai clic con il pulsante destro del mouse sul file .mobileprovision, seleziona Ulteriori informazioni>Anteprima. Cerca il campo Nome in Certificati.

Suggerimento

ProvisioningProfilePath è il percorso del file .mobileprovision scaricato. Ad esempio: /Users/username/Downloads/MyProvisioningProfile.mobileprovision
Al termine dello script, viene creato un file .ipa (ad esempio, com.single.wrap.ipa).

Importante

Se lo script non riesce, elimina la cartella decompressa e i file poiché potrebbero essere danneggiati. Decomprimi iOS-Archive.zip di nuovo prima di riprovare.

Distribuire l'app

Installa il file .ipa nei dispositivi registrati utilizzando l'app Finder.

Per la distribuzione aziendale con Microsoft Intune:

Condividi tramite