Registrazione del dispositivo e nuova firma dell'app

Importante

Visual Studio App Center è pianificato per il ritiro il 31 marzo 2025. Anche se è possibile continuare a usare Visual Studio App Center fino a quando non viene completamente ritirato, esistono diverse alternative consigliate a cui è possibile considerare la migrazione.

Altre informazioni sulle sequenze temporali e sulle alternative di supporto.

In questa pagina è possibile leggere i passaggi da eseguire durante la distribuzione di un'applicazione iOS a tester specifici. Informazioni sulla registrazione, il provisioning e la nuova firma dell'app del dispositivo. È anche possibile imparare a usare la funzionalità di App Center per rendere questo processo il più doloroso possibile. Infine, ci sono soluzioni ad alcuni problemi comuni che potresti riscontrare.

Firma dell'app, firma di nuovo e provisioning dei dispositivi

Gli sviluppatori firmano le app per la sicurezza come richiesto da Apple durante la distribuzione. Il requisito è lo stesso per la distribuzione tramite Xcode, App Center o iTunes Store. La firma del codice è una precauzione per garantire che nessuno abbia manomesso l'app. Per altre informazioni, vedere la documentazione di Apple sulla firma dell'app.

Il diagramma seguente mostra l'intero flusso di firma dell'app in App Center. Esaminiamo questi passaggi in modo più dettagliato.

La rifirmazione dell'app si applica solo quando si vuole distribuire un'app iOS a dispositivi di test specifici. Nel diagramma si vuole distribuire una versione dell'app ai dispositivi di Tester 1 e Tester 2. A tale scopo, devi firmare l'app con un profilo di provisioning ad hoc . Questo profilo di provisioning include un elenco di identificatori di dispositivo univoci (UDID). Solo i dispositivi presenti nell'elenco sono "di cui è stato effettuato il provisioning" o possono installare .ipa. App Center può rilevare se viene effettuato il provisioning di un dispositivo, perché è noto l'UDID del dispositivo da quando il tester ha registrato per la prima volta il dispositivo con App Center. Se viene rilevato che il dispositivo usato dal tester non è presente nell'elenco dei dispositivi di cui è stato effettuato il provisioning per il file con estensione ipa da scaricare, viene visualizzato il messaggio "Gli sviluppatori stanno lavorando a una versione per il dispositivo".

Dopo aver appreso quali dispositivi si vogliono usare per i test:

1. Registrare i dispositivi nell'account per sviluppatore Apple.
2. Aggiungerli al profilo di provisioning.
3. Generare un nuovo profilo di provisioning.
4. Scaricare il profilo di provisioning.
5. Creare l'app con questo profilo.

Quando viene visualizzato un altro nuovo dispositivo, ad esempio il dispositivo con UDID 3 nel diagramma, ripetere questi passaggi. Questo può essere scomodo e non si vuole modificare il sistema di integrazione continua o chiedere allo sviluppatore di continuare ad aggiungere nuovi dispositivi al profilo e rilasciare nuove build. È qui che entra in gioco la rifirmazione. Ciò significa prendere una compilazione dell'applicazione esistente e firmarla di nuovo (firma di nuovo) con un profilo di provisioning diverso, quindi non è necessario creare una nuova compilazione.

App Center consente di usare questo processo e di automatizzarlo. Questi sono i passaggi manuali e automatici illustrati nel diagramma, eseguendo il provisioning del dispositivo con UDID 3. App Center consente di registrare gli ID dispositivo tester nell'account per sviluppatore Apple, creare un nuovo profilo di provisioning e firmare di nuovo l'app dal portale di App Center. App Center richiede l'accesso all'account sviluppatore Apple per la registrazione dei dispositivi.

Per aggiungere manualmente i dispositivi a una versione esistente, è possibile usare Registrare i dispositivi nella pagina per un gruppo di distribuzione. Vedere Registrazione del dispositivo.

Per aggiungere automaticamente i dispositivi, attivare Gestisci automaticamente i dispositivi nelle impostazioni del gruppo di distribuzione. Questa opzione può essere accessibile solo tramite un gruppo di distribuzione a livello di app e non è disponibile tramite un gruppo globale. È possibile accedere a un gruppo di distribuzione a livello di app selezionando l'app in App Center e quindi facendo clic su Distribuisci. In Distribuisci fare clic su Gruppi e quindi sul gruppo specifico che si vuole gestire. È anche possibile acconsentire esplicitamente all'aggiunta automatica di dispositivi quando si distribuisce una nuova versione. Questa opzione si trova nel passaggio Dispositivi della procedura guidata per la distribuzione di una nuova versione.

App Center aggiunge il nuovo dispositivo all'elenco nel profilo di provisioning e firma nuovamente l'app con questo profilo di provisioning. Ora il nuovo dispositivo può anche installare l'app. Questi sono i passaggi inferiori del diagramma.

Funzionalità di rifirmazione

Alcuni aspetti da notare quando si usa di nuovo l'accesso in App Center:Some things to note when you use re-signing in App Center:

• La gestione automatica dei dispositivi nei gruppi funziona solo per la distribuzione a gruppi non pubblici e non condivisi.
• Se si distribuisce a singoli utenti, registrare i propri dispositivi manualmente e firmare nuovamente l'app. Per usare gli strumenti indicati in questo articolo, è prima necessario aggiungere i tester a un gruppo.
• Se si aggiungono più gruppi alla versione, configurare ogni gruppo separatamente usando Gestisci automaticamente i dispositivi nelle impostazioni del gruppo.
• La gestione dei dispositivi è necessaria solo per le app iOS firmate con un profilo sviluppatore o ad hoc.

Prerequisiti

Prima di poter usare le funzionalità del dispositivo di App Center, è necessario:

1. Chiedere al certificato di produzione usato per la firma dell'app originale.
2. Avere le credenziali per l'account sviluppatore Apple che detiene il ruolo di Titolare dell'account , Amministratore o Gestione app.
3. Usare Gestire manualmente l'accesso anziché gestire automaticamente la firma durante la distribuzione dell'app da Xcode.

Registrazione dispositivo

La registrazione di un dispositivo significa far parte dell'elenco dei dispositivi nel portale apple developer che può essere quindi incluso in un profilo di provisioning. Per registrare un dispositivo, selezionare un gruppo di distribuzione con almeno un dispositivo di cui non è ancora stato effettuato il provisioning e passare alla scheda Dispositivi . Verrà visualizzato un dispositivo con lo stato "non sottoposto a provisioning" e un messaggio nella parte superiore che indica che sono presenti dispositivi senza provisioning. Per registrare i dispositivi, seguire questa procedura:

1. Selezionare il pulsante Registra dispositivi .
2. Una finestra di dialogo richiede il nome utente e la password usati nel portale apple developer.
3. Dopo aver eseguito l'accesso con il nome utente e la password Apple, App Center aggiunge i dispositivi senza provisioning sia all'account sviluppatore Apple che al profilo di provisioning delle versioni.
4. Facoltativamente, è possibile caricare un file con estensione p12 per firmare nuovamente l'app e distribuirla ai dispositivi appena aggiunti. Altre informazioni su come generare un file con estensione p12.

Se si preferisce gestire la ri-compilazione dell'app con il profilo di provisioning aggiornato separatamente, è comunque possibile usare App Center per registrare automaticamente i dispositivi del tester nel portale per sviluppatori Apple senza il passaggio di nuova firma. A tale scopo, lasciare deselezionata rifirmare l'app e scaricare il profilo di provisioning aggiornato con il pulsante nella schermata di revisione. È anche possibile scaricare il profilo di provisioning tramite Xcode o il portale Apple Developer.

Distribuire una nuova versione

Quando si distribuisce una nuova versione a un gruppo in cui non è abilitata la gestione automatica dei dispositivi, un passaggio Dispositivi fa parte della procedura guidata. Il passaggio verifica se nel gruppo di distribuzione sono presenti dispositivi non sottoposto a provisioning; in questo caso, è possibile selezionare la casella di controllo Registrare i dispositivi e firmare di nuovo l'app . App Center esegue quindi tre operazioni:

1. Registrare i nuovi ID dispositivo nel portale per sviluppatori Apple.
2. Aggiungere i dispositivi al profilo di provisioning e scaricarli.
3. Firmare nuovamente il file binario caricato in modo che tutti i tester possano installarlo.

Il flusso richiede il nome utente e la password per il portale Apple Developer e il certificato usato per firmare l'app in fase di compilazione. Specificare il certificato come file con estensione p12 esportato. Altre informazioni su come generare un file con estensione p12. Se l'ID Apple e il certificato sono già stati salvati in App Center, è possibile sceglierlo dai menu a discesa.

Problemi di privacy relativi a nome utente e password

Quando si aggiungono le credenziali Apple e un certificato di firma ad App Center, viene usata una connessione sicura. App Center archivia le informazioni in un insieme di credenziali crittografato. Non è possibile che nessun utente scarichi o recuperi informazioni riservate dall'insieme di credenziali.

Se si specifica questo set di credenziali e un certificato, è automaticamente disponibile per i collaboratori dell'app, ma solo per quel servizio specifico. Ad esempio, ad esempio, lo sviluppatore X aggiunge credenziali e certificati al gruppo di distribuzione "Tester". Quindi, quando lo sviluppatore Y distribuisce una nuova versione al gruppo "Tester", il nome utente, la password e il certificato di X sono selezionati per impostazione predefinita. App Center li userà per lo sviluppatore Y. App Center usa solo l'ID Apple durante la transazione e non lo usa per altri elementi.

Limite di registrazione dei dispositivi Apple

Ogni account sviluppatore Apple ha un numero limitato di punti per i dispositivi per tipo di dispositivo. Apple funziona con cinque tipi di dispositivo: iPad, iPhone, iPod, Apple TV e Apple Watch. Ognuno di questi ha una limitazione di 100 dispositivi. Si supponga di registrare sei dispositivi, tutti iPhone. Hai quindi 94 ID dispositivo lasciati per iPhone e hai ancora 100 lasciati per ognuno dei quattro altri tipi di dispositivo. È possibile annullare la registrazione dei dispositivi solo una volta all'anno per recuperare tali slot.

Come generare un file con estensione p12

È possibile archiviare un certificato di distribuzione Apple e una chiave privata in un file Private Information Exchange (con estensione p12). A tale scopo, è necessario un certificato di produzione Apple archiviato nel computer locale. In caso contrario, non si avrà la chiave privata.

1. Aprire l'app Accesso portachiavi sul Mac e selezionare la categoria Certificati personali a sinistra.
2. Trovare il certificato di distribuzione corretto ed espanderlo per visualizzare la chiave privata corrispondente. a. Se la chiave privata non è presente, è necessario creare un nuovo certificato o eseguire questi passaggi nel computer in cui è stato creato il certificato.
3. Selezionare il certificato o la chiave privata o entrambi. Fare quindi clic con il pulsante destro del mouse sugli elementi selezionati per ottenere il menu di scelta rapida e selezionare l'azione che inizia con Esporta.
4. Selezionare un percorso su disco per salvare il file come file con estensione p12. Scegliere una password complessa per il file.

Come rimuovere i certificati e gli ID Apple da App Center

È possibile rimuovere i certificati e gli ID Apple da App Center negli account per sviluppatori.

1. Selezionare Impostazioni account sotto l'immagine del profilo nell'angolo in alto a destra.
2. Selezionare Account sviluppatore.
3. Rimuovere il segreto usando i tre punti verticali sul lato destro della tabella e quindi eliminare il certificato.
4. Verificare il nome del certificato e confermare l'azione irreversibile selezionando Elimina ancora una volta.

Altre informazioni sulla gestione dell'ID Apple e dei certificati.

Registrare manualmente i dispositivi con Apple

Se si sta provando a distribuire direttamente agli utenti all'esterno di App Center, è possibile seguire i passaggi del sito Web Apple Developer su come eseguire la distribuzione ai dispositivi registrati. I passaggi descrivono come aggiungere manualmente i dispositivi all'account e firmare nuovamente l'app.

Errori noti

Il profilo non è stato trovato

Quando si accede ad Apple tramite App Center, i profili di provisioning inclusi nell'applicazione vengono controllati rispetto a quelli inclusi nell'account per sviluppatore. Se un profilo usato in un file binario non viene trovato nell'account per sviluppatore Apple, App Center non può firmare nuovamente l'applicazione. Per risolvere questo problema, assicurarsi che l'account per sviluppatore Apple contenga tutti i profili di provisioning usati nell'applicazione. È possibile controllare i profili applicazione nella scheda Generale delle proprietà del progetto Xcode o le opzioni di firma del bundle iOS in Visual Studio per Mac.

Nota

Quando si tenta di effettuare il provisioning automatico di un file binario tramite App Center, in alcuni casi, i profili di provisioning generati automaticamente da Xcode genereranno l'esito negativo del provisioning automatico con l'errore seguente: Profilo denominato "iOS Team ..." non è stato trovato nell'account. Per risolvere il problema, creare e usare il profilo di provisioning creato manualmente.

Team non trovato

Quando si accede ad Apple tramite App Center, i team inclusi nelle applicazioni vengono controllati rispetto a quelli presenti nell'account per sviluppatore. Se un team usato nel file binario non viene trovato nell'account per sviluppatore Apple, App Center non può firmare nuovamente l'applicazione. Per risolvere questo problema, assicurarsi che l'account per sviluppatore Apple contenga il team usato nell'applicazione. È possibile controllare il team delle applicazioni nella scheda Generale delle proprietà del progetto Xcode o le opzioni di firma del bundle iOS in Visual Studio per Mac.

Contratto di licenza aggiornato

Apple aggiorna periodicamente il contratto di licenza. Per continuare a usare il portale Apple Developer, è necessario leggere e accettare la licenza aggiornata.

1. Accedere al portale Apple Developer.
2. Seguire le istruzioni fornite per accettare il contratto di licenza.

App Center non può essere utile per il contenuto della licenza o del flusso per il contratto di licenza.

Il tester non ha registrato l'ID dispositivo

Se un tester ha selezionato accidentalmente l'ho già registrato, seguire questa procedura per registrare manualmente un dispositivo:

1. Passare al https://install.appcenter.ms/register-device dispositivo mobile.
2. Selezionare Registra e seguire le istruzioni visualizzate.