Introduzione a Microsoft Intune App SDKGet started with the Microsoft Intune App SDK

Questa guida illustra come abilitare rapidamente un'app per dispositivi mobili per i criteri di protezione delle app con Microsoft Intune.This guide will help you quickly enable your mobile app for app protection policies with Microsoft Intune. Può essere utile per capire i vantaggi di Intune App SDK descritti nella panoramica di Intune App SDK.You may find it useful to first understand the benefits of the Intune App SDK, as explained in the Intune App SDK overview.

Intune App SDK supporta scenari simili in iOS e Android ed è progettato per offrire un'esperienza coerente nelle diverse piattaforme agli amministratori IT.The Intune App SDK supports similar scenarios across iOS and Android, and is intended to create a consistent experience across the platforms for IT admins. A causa delle limitazioni delle piattaforme, tuttavia, il supporto di alcune funzionalità può essere leggermente diverso.But there are small differences in the support of certain features, because of platform limitations.

Registrare l'app store in MicrosoftRegister your store app with Microsoft

Se l'app è interna all'organizzazione e non sarà disponibile pubblicamente:If your app is internal to your organization and will not be publicly available:

Non è necessario registrare l'app.You do not need to register your app. Per le app line-of-business interne, l'amministratore IT distribuirà l'app internamente.For internal line-of-business apps, the IT administrator will deploy the app internally. Intune rileverà che l'app è stata creata con l'SDK e consentirà all'amministratore IT di applicare i criteri di protezione delle app.Intune will detect that the app has been built with the SDK, and will let the IT administrator apply app protection policy to it. È possibile passare alla sezione Abilitare un'app iOS o Android per i criteri di protezione delle app.You can skip to the section Enable your iOS or Android app for app protection policy.

Se l'app verrà rilasciata a un app store pubblico, ad esempio l'App Store Apple o Google Play:If your app will be released to a public app store, like the Apple App Store or Google Play:

È prima di tutto necessario registrare l'app in Microsoft Intune e accettare le condizioni di registrazione.You must first register your app with Microsoft Intune and agree to the registration terms. Gli amministratori IT possono applicare i criteri di protezione delle app all'app abilitata, che verrà elencata come partner di app di Intune.IT administrators can then apply app protection policy to the enlightened app, which will be listed as an Intune app partner.

Fino alla conclusione della registrazione e all'avvenuta conferma da parte del team di Microsoft Intune, gli amministratori di Intune non potranno applicare i criteri di protezione delle app al collegamento diretto dell'app.Until registration has been finished and confirmed by the Microsoft Intune team, Intune administrators will not have the option to apply app protection policy to your app's deep link. Microsoft aggiungerà l'app anche alla relativa pagina dei partner di Microsoft Intune.Microsoft will also add your app to its Microsoft Intune Partners page. Verrà quindi visualizzata l'icona dell'app per mostrare che supporta i criteri di protezione delle app di Intune.There, the app's icon will be displayed to show that it supports Intune app protection policies.

Per avviare il processo di registrazione, riempire il questionario per partner di app di Microsoft Intune.To begin the registration process, fill out the Microsoft Intune App Partner Questionnaire.

Microsoft userà gli indirizzi di posta elettronica specificati nelle risposte al questionario per contattare gli utenti e continuare il processo di registrazione.We will use the email addresses listed in your questionnaire response to reach out and continue the registration process. Lo stesso indirizzo verrà usato anche per contattare l'utente per eventuali chiarimenti.Additionally, we use your registration email address to contact you if we have any concerns.

Nota

Tutte le informazioni raccolte nel questionario e nella corrispondenza tramite posta elettronica con il team di Microsoft Intune rispetteranno l'Informativa sulla privacy Microsoft.All information collected in the questionnaire and through email correspondence with the Microsoft Intune team will honor the Microsoft Privacy Statement.

Cosa accade durante il processo di registrazione:What to expect in the registration process:

  1. Dopo l'invio del questionario, si verrà contattati da Microsoft all'indirizzo di posta elettronica specificato nella registrazione per confermare la ricezione o per richiedere altre informazioni necessarie al completamento della registrazione.After you have submitted the questionnaire, we will contact you via your registration email address, to either confirm successful receipt or request additional information to finish the registration.

  2. Dopo che il team di Intune ha ricevuto tutte le informazioni necessarie, verrà inviato il contratto per i partner di app di Microsoft Intune da firmare.After we receive all necessary information from you, we will send you the Microsoft Intune App Partner Agreement to sign. In questo contratto sono indicate le condizioni che la società deve accettare per poter diventare partner di app di Microsoft Intune.This agreement describes the terms that your company must accept before it becomes a Microsoft Intune app partner.

  3. Sarà inviata una conferma quando l'app è registrata correttamente con il servizio di Microsoft Intune e quando l'app è disponibile sul sito dei partner di Microsoft Intune.You will be notified when your app is successfully registered with the Microsoft Intune service and when your app is featured on the Microsoft Intune partners site.

  4. Infine, verrà aggiunto un collegamento diretto dell'app al prossimo aggiornamento mensile dei servizi di Intune.Finally, your app's deep link will be added to the next monthly Intune Service update. Ad esempio, se le informazioni di registrazione vengono completate nel mese di luglio, il collegamento diretto sarà supportato a metà agosto.For example, if the registration information is finished in July, the deep link will be supported in mid-August.

Se il collegamento diretto dell'app dovesse cambiare, sarà necessario registrare di nuovo l'app.If your app's deep link changes in the future, you will need to re-register your app.

Nota

È necessario comunicare se l'app viene aggiornata con una nuova versione di Intune App SDK.Please inform us if you update your app with a new version of the Intune App SDK.

Scaricare i file SDKDownload the SDK files

I file di Intune App SDK per iOS e Android nativi sono ospitati in un account Microsoft GitHub.The Intune App SDKs for native iOS and Android are hosted on a Microsoft GitHub account. I repository pubblici contengono rispettivamente i file SDK per iOS e Android nativi:These public repositories have the SDK files for native iOS and Android, respectively:

Se l'app è basata su Xamarin o Cordova, usare queste varianti dell'SDK:If your app is a Xamarin or Cordova app, please use these SDK variants:

Si consiglia di registrarsi per un account GitHub utile per eseguire operazioni di biforcazione ed estrazione dal repository.It's a good idea to sign up for a GitHub account that you can use to fork and pull from our repositories. GitHub consente agli sviluppatori di comunicare con il team del prodotto Microsoft, aprire problemi e ricevere risposte rapide, visualizzare le note sulla versione e fornire commenti e suggerimenti a Microsoft.GitHub lets developers communicate with our product team, open issues and receive quick responses, view release notes, and provide feedback to Microsoft. Per domande su Intune App SDK GitHub, contattare msintuneappsdk@microsoft.com.For questions on the Intune App SDK GitHub, contact msintuneappsdk@microsoft.com.

Abilitare un'app iOS o Android per i criteri di protezione delle appEnable your iOS or Android app for app protection policy

Per integrare Intune App SDK nelle app, è necessario consultare una delle guide per gli sviluppatori seguenti:You will need one of the following developer guides to help you integrate the Intune App SDK into your app:

Configurazione della telemetria per l'appConfigure Telemetry for your app

Microsoft Intune raccoglie i dati sulle statistiche di utilizzo dell'app.Microsoft Intune collects data on usage statistics for your app.

  • Intune App SDK per iOS: l'SDK registra i dati della telemetria SDK negli eventi di utilizzo per impostazione predefinita.Intune App SDK for iOS: The SDK logs SDK telemetry data on usage events by default. Questi dati vengono inviati a Microsoft Intune.This data is sent to Microsoft Intune.

    • Se si sceglie di non inviare i dati della telemetria a Microsoft Intune dall'app, è necessario disabilitare la trasmissione della telemetria SDK impostando la proprietà MAMTelemetryDisabled su "YES" nel dizionario IntuneMAMSettings.If you choose not to send SDK telemetry data to Microsoft Intune from your app, you must disable telemetry transmission by setting the property MAMTelemetryDisabled to "YES" in the IntuneMAMSettings dictionary.
  • Intune App SDK per Android: i dati della telemetria non vengono registrati con l'SDK.Intune App SDK for Android: Telemetry data is not logged through the SDK.

Passaggi successivi dopo l'integrazioneNext steps after integration

Test dell'appTest your app

Dopo aver completato i passaggi necessari per integrare l'app per iOS o Android con Intune App SDK, è necessario assicurarsi che tutti i criteri di protezione delle app siano abilitati e funzionanti per l'utente e l'amministratore IT. Per testare l'app integrata, è necessario quanto segue:After you finish the necessary steps to integrate your iOS or Android app with the Intune App SDK, you will need to ensure that all the app protection policies are enabled and functioning for the user and the IT admin. To test your integrated app, you will need the following:

  • Account di prova per Microsoft Intune: per testare le funzionalità di protezione delle app di Intune nelle app abilitate per Intune, è necessario un account di Microsoft Intune.Microsoft Intune test account: To test your Intune-enlightened app against Intune app protection features, you will need a Microsoft Intune account.

    • Gli ISV che abilitano le proprie app dello store iOS e Android per i criteri di protezione delle app di Intune, riceveranno un codice promozionale al termine della registrazione in Microsoft Intune, come descritto nel passaggio relativo alla registrazione.If you are an ISV enabling your iOS or Android store apps for Intune app protection policy, you will receive a promo code after you finish the registration with Microsoft Intune, as outlined in the registration step. Con il codice promozionale sarà possibile richiedere una versione di valutazione di Microsoft Intune per un anno di uso esteso.The promo code will let you sign up for a Microsoft Intune trial for one year of extended use.

    • Se si sta sviluppando un'app line-of-business che non verrà inviata allo store, l'accesso a Microsoft Intune deve essere fornito dall'organizzazione.If you are developing a line-of-business app that will not be shipped to the store, you are expected to have access to Microsoft Intune through your organization. Si può anche richiedere un mese di valutazione gratuita con Microsoft Intune.You can also sign up for a one-month free trial in Microsoft Intune.

  • Criteri di protezione delle app di Intune: per testare l'app con tutti i criteri di protezione delle app di Intune, è necessario conoscere il comportamento previsto per ogni impostazione dei criteri.Intune app protection policies: To test your app against all the Intune app protection policies, you should know what the expected behavior is for each policy setting. Vedere le descrizioni dei criteri di protezione delle app iOS e dei criteri di protezione delle app Android.See the descriptions for iOS app protection policies and Android app protection policies.

  • Risoluzione dei problemi: se si verificano problemi durante i test manuali dell'esperienza utente per l'app, vedere Risolvere i problemi relativi alla gestione di applicazioni mobili.Troubleshoot: If you run into any issues while manually testing your app's user experience, check out the Troubleshooting MAM. Questo articolo offre assistenza per i problemi comuni, le finestre di dialogo e i messaggi di errore che possono presentarsi nelle app abilitate per Intune.This article offers help for common issues, dialogs, and error messages that may be experienced in Intune-enlightened apps.

Aggiungere il logo all'app (facoltativo)Badge your app (optional)

Dopo aver verificato che i criteri di protezione delle app di Intune funzionano correttamente in un'app, è possibile aggiungere all'icona dell'app il logo di protezione delle app di Intune.After validating that Intune app protection policies work in your app, you can badge your app icon with the Intune app protection logo.

Questo logo segnala agli amministratori IT, agli utenti finali e ai potenziali clienti di Intune che l'app supporta i criteri di protezione delle app di Intune,This badge indicates to IT administrators, end-users, and potential Intune customers that your app works with Intune app protection policies. favorendo così l'utilizzo e l'adozione dell'app da parte dei clienti di Intune.It encourages the usage and adoption of your app by Intune customers.

Il logo è un'icona a forma di valigetta, come illustrato negli esempi seguenti:The badge is a briefcase icon and can be seen in the samples below:

Esempio di logo 1 Esempio di logo 2

Cosa serve per aggiungere il logo all'app:What you'll need to badge your app:

  • Un'applicazione per la modifica di immagini che supporta la lettura di file con estensione eps oppure un'applicazione Adobe in grado di leggere file con estensione ai.An image manipulation application that can read .eps files, or an Adobe application that can read .ai files.

  • È possibile trovare linee guida e asset per l'aggiunta del logo alle app di Intune nella sezione dedicata a Microsoft Intune di GitHub.You can find the Intune app badge assets and guidelines on the Microsoft Intune GitHub.