Distribuisci app

Di seguito puoi trovare informazioni utili sulla distribuzione delle app nella versione gestita del Google Play Store.

Installa app

Puoi installare app per Android dal Google Play Store sui dispositivi tramite i criteri. 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 è indicato 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.

Potrai quindi 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 di test chiuso (canale chiuso) per testare le versioni di pre-release dell'app con un gruppo di tester. Questa procedura è chiamata test chiuso. Il supporto della distribuzione di canali chiusi 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 tramite i criteri.

App idonee per i test chiusi

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

  • Una versione di produzione dell'app è pubblicata su Google Play (o la versione gestita di Google Play per le app private)
  • In Play Console, l'opzione Funzionalità avanzate della versione gestita di Google Play è abilitata nella pagina Prezzi e distribuzione dell'app.
  • Qualsiasi versione chiusa dell'app soddisfa i requisiti relativi ai codici di versione.

Aggiungere 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 tuoi clienti possono trovare il proprio ID organizzazione utilizzando 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 pagina Prezzi e distribuzione di Play Console. Per le istruzioni, vedi Pubblicare app private da Play Console.

Distribuisci canali chiusi agli utenti

Per recuperare un elenco dei canali disponibili per un'azienda per un'app specificata, chiama il numero enterprises.applications. L'elenco appTrackInfo[] incluso nella risposta contiene quanto segue per le app specificate:

  • trackId: identificatore univoco del canale, recuperato da releaseTrackId nell'URL della pagina in Play Console che mostra 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 nelle norme del dispositivo:

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

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

I trackId verranno rimossi automaticamente dalla chiamata di enterprises.applications in determinati scenari come quelli seguenti:

  • L'APK del canale viene promosso in un altro canale o in 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 tua console EMM per offrire ai clienti un'esperienza di gestione della mobilità unificata.

iframe-riproduzione-gestita
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 a diverse pagine:

  • Cerca app: consente agli amministratori IT di cercare e sfogliare le app di Google Play, visualizzare i dettagli delle app e selezionare le app.
  • App private: consente agli amministratori IT di pubblicare e gestire app private per la loro azienda.
  • App web: consente agli amministratori IT di pubblicare e distribuire scorciatoie per i siti web come app.
  • Organizzazione delle app: consente agli amministratori IT di configurare il modo in cui sono organizzate le app 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 tua console

Passaggio 1. Genera un token web

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

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

Passaggio 2: Eseguire il rendering dell'iframe

Di seguito è riportato 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 descritto sopra.

Parametri URL

La tabella seguente 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 Obbligatorio Descrizione
token N/D Sì Il token restituito dal Passaggio 1.
iframehomepage N/D No La pagina iniziale mostrata quando viene eseguito il rendering dell'iframe. I valori possibili sono PLAY_SEARCH, WEB_APPS, PRIVATE_APPS e STORE_BUILDER (organizza 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/D No Un tag BCP 47 ben strutturato, 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. Questa modalità è deprecata. Utilizza SELECT. La modalità APPROVE funziona solo se il criterio PlaySearch.ApproveApps è impostato su true nel token web.
showsearchbox Cerca app No TRUE (impostazione predefinita): visualizza 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. Verrà 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);

Carica la tua app su Google Play Store

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

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