Avvia API gestore

Controlla come viene lanciata la tua app.

Thomas Steiner

L'API Launch Gestori ti consente di controllare le modalità di avvio dell'app, ad esempio se utilizza una finestra esistente o una nuova e se la finestra scelta viene indirizzata all'URL di avvio. Come per l'API File Handing, anche questo accoda un oggetto LaunchParams nel valore window.launchQueue della pagina avviata.

Stato attuale

Passaggio Stato
1. Crea messaggio esplicativo Completato
2. Crea la bozza iniziale delle specifiche Completato
3. Raccogli feedback e ottimizza la progettazione Completato
4. Prova dell'origine. Completato
5. Lancio Completato

Utilizzo dell'API Launch Gestori

Supporto del browser

Il gestore del lancio è disponibile solo su ChromeOS.

Supporto dei browser

  • 110
  • 110
  • x
  • x

Origine

Interfacce

L'API Launch Gestori definisce due nuove interfacce.

LaunchParams : un oggetto contenente l'elemento targetURL che deve essere gestito dal consumatore. LaunchQueue : avvia le code fino a quando non vengono gestite dal consumatore specificato.

Membro del manifest launch_handler

Per specificare in modo dichiarativo il comportamento di lancio dell'app, aggiungi il membro del file manifest launch_handler al file manifest. Ha un sottocampo chiamato client_mode. Ti permette di controllare se un client nuovo o esistente deve essere avviato e se questo client deve essere esplorato. L'esempio seguente mostra un file con valori esemplari che instradano sempre tutti i lanci a un nuovo client.

{
  "launch_handler": {
    "client_mode": "navigate-new"
  }
}

Se non specificato, il valore predefinito di launch_handler è {"client_mode": "auto"}. I valori consentiti per i campi secondari sono:

  • client_mode:
    • navigate-new: viene creato un nuovo contesto di navigazione in una finestra dell'app web per caricare l'URL di destinazione del lancio.
    • navigate-existing: l'ultima persona che ha interagito con il contesto di navigazione nella finestra di un'app web viene aperta all'URL di destinazione del lancio.
    • focus-existing: l'ultima interazione con il contesto di navigazione nella finestra di un'app web viene scelta per gestire il lancio. Un nuovo oggetto LaunchParams con targetURL impostato sull'URL di avvio verrà accodato nella window.launchQueue del documento.
    • auto: spetta allo user agent decidere cosa fare meglio per la piattaforma. Ad esempio, i dispositivi mobili supportano solo client singoli e utilizzano existing-client, mentre i computer desktop supportano più finestre e utilizzano navigate-new per evitare la perdita di dati.

La proprietà client_mode accetta anche un elenco (array) di valori, in cui verrà utilizzato il primo valore valido. Ciò consente di aggiungere nuovi valori alle specifiche senza interrompere la compatibilità con le implementazioni esistenti.

Ad esempio, se viene aggiunto il valore ipotetico "focus-matching-url", i siti dovrebbero specificare "client_mode": ["focus-matching-url", "navigate-existing"] per continuare a controllare il comportamento dei browser meno recenti che non supportavano "focus-matching-url".

Utilizzo di window.launchQueue

Nel codice seguente, la funzione extractSongID() estrae un songID dall'URL passato al momento dell'avvio. Viene utilizzato per riprodurre un brano nella PWA di un lettore musicale.

if ('launchQueue' in window) {
  launchQueue.setConsumer((launchParams) => {
    if (launchParams.targetURL) {
      const songID = extractSongId(launchParams.targetURL);
      if (songID) {
        playSong(songID);
      }
    }
  });
}

Demo

Puoi vedere una demo dell'API Launch Gestori in azione nella demo di lancio del gestore di PWA. Assicurati di controllare il codice sorgente dell'applicazione per vedere come utilizza l'API Launch Gestori.

  1. Installa l'app Musicr 2.0 su un dispositivo ChromeOS.
  2. Inviati un link in un'applicazione di chat del modulo https://launch-handler.glitch.me?track=https://example.com/music.mp3. Puoi personalizzare https://example.com/music.mp3 per qualsiasi URL che rimandi a un file audio, ad esempio https://launch-handler.glitch.me?track=https://cdn.glitch.me/3e952c9c-4d6d-4de4-9873-23cf976b422e%2Ffile_example_MP3_700KB.mp3?v=1638795977190.
  3. Fai clic sul link nell'app di chat e osserva come si apre Musicr 2.0 e riproduce la traccia.
  4. Fai di nuovo clic sul link nell'app di chat e noterai che non riceverai una seconda istanza di Musicr 2.0.

Feedback

Il team di Chromium vuole saperne di più sulla tua esperienza con l'API Launch Gestori.

Parlaci della progettazione dell'API

C'è qualcosa nell'API che non funziona come previsto? Oppure mancano metodi o proprietà per implementare la tua idea? Hai una domanda o un commento sul modello di sicurezza? Invia un problema relativo alle specifiche sul repository GitHub corrispondente o aggiungi le tue opinioni a un problema esistente.

Segnalare un problema con l'implementazione

Hai trovato un bug nell'implementazione di Chromium? Oppure l'implementazione è diversa dalle specifiche? Segnala un bug all'indirizzo new.crbug.com. Assicurati di includere il maggior numero di dettagli possibile, semplici istruzioni per la riproduzione e inserisci Blink>AppManifest nella casella Componenti. Glitch è la soluzione perfetta per condividere riproduzioni in modo facile e veloce.

Mostra il supporto per l'API

Intendi utilizzare l'API Launch Gestori? Il supporto pubblico aiuta il team di Chromium a dare priorità alle funzionalità e mostra agli altri fornitori di browser quanto sia fondamentale supportarle.

Invia un tweet a @ChromiumDev utilizzando l'hashtag #LaunchHandler e facci sapere dove e come lo utilizzi.

Link utili