Distribuzione di app

Le seguenti sezioni forniscono informazioni utili sulla distribuzione delle app nella versione gestita di Google Play Store.

Installa app

Puoi installare app per Android dal Google Play Store sui dispositivi utilizzando il criterio. Per utilizzare questa funzionalità, devi conoscere il nome del pacchetto dell'app che vuoi installare. Per trovare il nome del pacchetto dell'app, hai due opzioni:

  1. Il nome del pacchetto dell'app è riportato nell'URL della pagina del Google Play Store. Ad esempio, l'URL della pagina dell'app Google Chrome è 

    https://play.google.com/store/apps/details?id=com.android.chrome
    e il nome del pacchetto è com.android.chrome.

  2. Puoi incorporare l'iframe della versione gestita di Google Play nella tua console EMM per consentire ai tuoi clienti di esplorare il Google Play Store. Quando il cliente seleziona un'app nell'iframe, la console EMM riceve il nome del pacchetto nell'evento.

Dopodiché potrai aggiungere l'app nei criteri del dispositivo:

"applications":[
   {
      "installType":"FORCE_INSTALLED",
      "packageName":"com.android.chrome",
   },
],

Quando applichi il criterio a un dispositivo, l'app verrà installata sul dispositivo o aggiunta alla versione gestita del Google Play Store sul dispositivo.

Distribuire app per i test chiusi

In Play Console, gli sviluppatori di app possono creare una release chiusa (canale chiuso) per testare le versioni di pre-release della loro app con un gruppo di tester. Questa operazione è chiamata test chiuso. Il supporto della distribuzione a canale chiuso consente alle organizzazioni di testare le app di terze parti e le app private che sviluppano internamente.

Quando configuri un test chiuso in Play Console, gli sviluppatori di app possono scegliere come target fino a 100 organizzazioni (enterprises). Puoi utilizzare l'API Android Management per recuperare i canali chiusi destinati a un'azienda e distribuire questi canali chiusi ai dispositivi utilizzando il criterio.

App idonee per i test chiusi

Prima di configurare un test chiuso, gli sviluppatori di app devono assicurarsi che la propria app soddisfi i seguenti requisiti:

  • Una versione di produzione dell'app viene pubblicata su Google Play (o nella versione gestita di Google Play per le app private)
  • In Google Play Console, la versione gestita di Google Play è attivata nella pagina Impostazioni avanzate dell'app.
  • Tutte le versioni chiuse dell'app soddisfano i requisiti relativi ai codici di versione.

Aggiungi un'azienda ai test chiusi

Quando configuri un test chiuso, gli sviluppatori di app possono concedere a un'organizzazione l'accesso ai test chiusi aggiungendo il proprio ID organizzazione. I clienti possono individuare l'ID organizzazione seguendo queste istruzioni:

  1. Accedi alla versione gestita di Google Play con un account amministratore.
  2. Fai clic su Impostazioni amministratore.
  3. Copia la stringa ID organizzazione dalla casella Informazioni sull'organizzazione e inviala allo sviluppatore.

Per le app private, lo sviluppatore deve anche aggiungere l'ID organizzazione di ogni azienda partecipante nella scheda Versione gestita di Google Play della pagina Impostazioni avanzate dell'app. Per istruzioni, vedi Pubblicare app private da Play Console.

Distribuisci canali chiusi agli utenti

Per recuperare un elenco di canali disponibili per un'azienda per un'app specifica, chiama enterprises.applications. L'elenco appTrackInfo[] incluso nella risposta contiene quanto segue per le app specifiche:

  • trackId: l'identificatore univoco del canale, tratto dal valore releaseTrackId nell'URL della pagina in Play Console in cui vengono visualizzate le informazioni sul canale dell'app.
  • trackAlias: il nome leggibile della traccia, modificabile in Play Console.

Per installare un canale chiuso sul dispositivo di un utente, specifica accessibleTrackIds nei criteri del dispositivo:

"applications":[
   {
      "installType":"AVAILABLE",
      "packageName":"com.google.android.gm",
      "accessibleTrackIds":[
          "123456",
          "789101"
       ]
   },
],

Se un criterio contiene più canali della stessa app (come nell'esempio sopra), il criterio installa il canale con il codice versione più recente.

I trackId verranno rimossi automaticamente dalla chiamata a enterprises.applications in alcuni scenari come i seguenti:

  • L'APK del canale è promosso a un altro canale o alla versione di produzione.
  • La versione di produzione viene aggiornata con una versione superiore rispetto al canale.
  • Uno sviluppatore interrompe il canale.

iframe della versione gestita di Google Play

Con l'iframe della versione gestita di Google Play, puoi incorporare la versione gestita di Google Play direttamente nella console EMM per offrire ai clienti un'esperienza di gestione della mobilità unificata.

Managed-play-iframe
Figura 1. iframe della versione gestita di Google Play

L'iframe contiene una barra del titolo e un menu laterale espandibile. Dal menu, gli utenti possono passare alle varie pagine:

  • Cerca nelle app: consente agli amministratori IT di cercare e sfogliare le app di Google Play, visualizzare i dettagli delle app e selezionare app.
  • App private: consente agli amministratori IT di pubblicare e gestire app private per la propria azienda.
  • App web: consente agli amministratori IT di pubblicare e distribuire scorciatoie per i siti web sotto forma di app.
  • Organizzazione delle app: consente agli amministratori IT di configurare il modo in cui le app sono organizzate nell'app Play Store sui dispositivi degli utenti.

Funzionalità

In questa sezione vengono descritte le funzionalità disponibili nell'iframe della versione gestita di Google Play. Per informazioni su come incorporare l'iframe e implementare queste funzionalità, consulta Aggiungere l'iframe alla console.

Aggiungi l'iframe alla console

Passaggio 1. Genera un token web

Chiama enterprises.webTokens.create per generare un token web che identifichi l'azienda. La risposta contiene l'elemento value del token.

  • Imposta parentFrameUrl sull'URL del frame principale che ospita l'iframe.
  • Utilizza iframeFeature per specificare le funzionalità da attivare nell'iframe: PLAY_SEARCH, PRIVATE_APPS, WEB_APPS, STORE_BUILDER (organizzare le app). Se il criterio iframeFeature non viene configurato, l'iframe attiva tutte le funzionalità per impostazione predefinita.

Passaggio 2. Eseguire il rendering dell'iframe

Ecco un esempio di come eseguire il rendering dell'iframe della versione gestita di Google Play:

<script src="https://apis.google.com/js/api.js"></script>
<div id="container"></div>
<script>
  gapi.load('gapi.iframes', function() {
    var options = {
      'url': 'https://play.google.com/work/embedded/search?token=web_token&mode=SELECT',
      'where': document.getElementById('container'),
      'attributes': { style: 'width: 600px; height:1000px', scrolling: 'yes'}
    }

    var iframe = gapi.iframes.getContext().openChild(options);
  });
</script>

Questo codice genera un iframe all'interno del contenitore div. Gli attributi da applicare al tag iframe possono essere impostati con l'opzione "attributes", come accennato in precedenza.

Parametri URL

La seguente tabella elenca tutti i parametri disponibili per l'iframe che possono essere aggiunti all'URL come parametri URL, ad esempio:

'url': 'https://play.google.com/work/embedded/search?token=web_token&mode=SELECT&showsearchbox=TRUE',
Parametro Pagina Obbligatorie Descrizione
token N/A Sì Il token restituito dal Passaggio 1.
iframehomepage N/A No La pagina iniziale è visualizzata quando viene eseguito il rendering dell'iframe. I valori possibili sono PLAY_SEARCH, WEB_APPS, PRIVATE_APPS e STORE_BUILDER (organizzare le app). Se non specificato, il seguente ordine di precedenza determina quale pagina viene visualizzata: 1. PLAY_SEARCH, 2. PRIVATE_APPS, 3. WEB_APPS, 4. STORE_BUILDER.
locale N/A No Un tag per la lingua BCP 47 in un formato corretto utilizzato per localizzare i contenuti nell'iframe. Se non specificato, il valore predefinito è en_US.
mode Cerca app No SELECT: consente agli amministratori IT di selezionare le app.
APPROVE (impostazione predefinita): consente agli amministratori IT di selezionare, approvare e annullare l'approvazione delle app.
showsearchbox Cerca app No TRUE (predefinito): mostra la casella di ricerca e avvia la query di ricerca dall'interno dell'iframe.
FALSE: la casella di ricerca non viene visualizzata.
search Cerca app No Stringa di ricerca. Se specificato, l'iframe indirizza l'amministratore IT ai risultati di ricerca con la stringa specificata.

Passaggio 3. Gestire gli eventi iframe

Nell'ambito dell'integrazione dovresti anche gestire i seguenti eventi.

EventoDescrizione
onproductselect L'utente seleziona o approva un'app. Viene restituito un oggetto contenente:
{
    "packageName": The package name of the app, e.g. "com.google.android.gm",
    "productId": The product ID of the app, e.g. "app:com.google.android.gm",
    "action": The type of action performed on the document. Possible values are:
    "approved", "unapproved" or "selected." If you implement the iframe in SELECT
    mode, the only possible value is "selected".
}
L'esempio seguente mostra come ascoltare onproductselect: 
iframe.register('onproductselect', function(event) {
  console.log(event);
}, gapi.iframes.CROSS_ORIGIN_IFRAMES_FILTER);

Caricare la propria app sul Google Play Store

Se tu o il tuo cliente sviluppate un'app per Android, potete caricarla sul Play Store utilizzando Google Play Console.

Se non vuoi che l'app sia disponibile pubblicamente sul Play Store, puoi limitare l'app a una sola azienda usando Google Play Console. Un'altra opzione è pubblicare un'app privata in modo programmatico utilizzando l'API Google Play Custom App Publishing. Le app private sono disponibili solo per l'azienda a cui sono limitate. Possono comunque essere installati utilizzando un criterio, ma non sono visibili agli utenti esterni alla tua azienda.