Cómo crear accesos directos a aplicaciones

François Beaufort
François Beaufort
GitHub

Los accesos directos a aplicaciones ayudan a los usuarios a iniciar rápidamente tareas comunes o recomendadas dentro de tu aplicación web. El fácil acceso a esas tareas desde cualquier lugar en el que se muestre el ícono de la app mejorará la productividad de los usuarios y aumentará su participación en la aplicación web.

El método moderno

Define accesos directos a la app en el manifiesto de la app web

Para invocar el menú de accesos directos de la app, haz clic con el botón derecho en el ícono de la app en la barra de tareas (Windows) o en la estación de acoplamiento (macOS) en el escritorio del usuario, o bien mantén presionado el ícono del selector de la app en Android.

Menú de accesos directos de una app abierto en Android.
Menú de combinaciones de teclas de la app abierto en Android
Menú de combinaciones de teclas de la app abierto en Windows.
Menú de combinaciones de teclas de la app abierto en Windows

El menú de combinaciones de teclas de la app solo se muestra para las aplicaciones web progresivas que están instaladas. Consulta Instalación en nuestro módulo Aprende sobre AWP para obtener información sobre los requisitos de instalación.

Cada atajo de la app expresa una intención del usuario, cada una de las cuales está asociada con una URL dentro del alcance de tu app web. La URL se abre cuando un usuario activa el atajo de la app.

De manera opcional, los atajos de la app se declaran en el miembro del array shortcuts del manifiesto de la app web. A continuación, se muestra un ejemplo de un posible manifiesto de app web.

{
  "name": "Player FM",
  "start_url": "https://player.fm?utm_source=homescreen",
  "shortcuts": [
    {
      "name": "Open Play Later",
      "short_name": "Play Later",
      "description": "View the list of podcasts you saved for later",
      "url": "/play-later?utm_source=homescreen",
      "icons": [{ "src": "/icons/play-later.png", "sizes": "192x192" }]
    },
    {
      "name": "View Subscriptions",
      "short_name": "Subscriptions",
      "description": "View the list of podcasts you listen to",
      "url": "/subscriptions?utm_source=homescreen",
      "icons": [{ "src": "/icons/subscriptions.png", "sizes": "192x192" }]
    }
  ]
}

Navegadores compatibles

  • Chrome: 96.
  • Edge: 96.
  • Firefox: No es compatible.
  • Safari: 17.4.

Origen

La forma clásica

Si la app aún no está instalada, puedes sugerirle al usuario que arrastre algunos vínculos de tu página web y los suelte en la barra de favoritos del navegador. De esta manera, pueden iniciar rápidamente tareas comunes o recomendadas dentro de tu app web.

Lecturas adicionales

Demostración

HTML

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <meta name="color-scheme" content="dark light" />
    <link rel="manifest" href="manifest.json" />
    <title>How to create app shortcuts</title>
    <!-- TODO: Devsite - Removed inline handlers -->
    <!-- <script>
      if ('serviceWorker' in navigator) {
        window.addEventListener('load', () => {
          navigator.serviceWorker.register('sw.js');
        });
      }
    </script>
    <script type="module" src="script.js"></script> -->
  </head>
  <body>
    <h1>How to create app shortcuts</h1>
    <ol>
      <li>
        You can drag these <a href="blue.html">blue page</a> or
        <a href="red.html">red page</a> links to the bookmarks bar
        and access them later.
      </li>
      <li>
        Install the app by clicking the button below. After the installation,
        the button is disabled.
        <p>
          <button disabled type="button">Install</button>
        </p>
      </li>
    </ol>
  </body>
</html>

JS


        // The install button.
const installButton = document.querySelector('button');

// Only relevant for browsers that support installation.
if ('BeforeInstallPromptEvent' in window) {
  // Variable to stash the `BeforeInstallPromptEvent`.
  let installEvent = null;

  // Function that will be run when the app is installed.
  const onInstall = () => {
    // Disable the install button.
    installButton.disabled = true;
    // No longer needed.
    installEvent = null;
  };

  window.addEventListener('beforeinstallprompt', (event) => {
    // Do not show the install prompt quite yet.
    event.preventDefault();
    // Stash the `BeforeInstallPromptEvent` for later.
    installEvent = event;
    // Enable the install button.
    installButton.disabled = false;
  });

  installButton.addEventListener('click', async () => {
    // If there is no stashed `BeforeInstallPromptEvent`, return.
    if (!installEvent) {
      return;
    }
    // Use the stashed `BeforeInstallPromptEvent` to prompt the user.
    installEvent.prompt();
    const result = await installEvent.userChoice;
    // If the user installs the app, run `onInstall()`.
    if (result.outcome === 'accepted') {
      onInstall();
    }
  });

  // The user can decide to ignore the install button
  // and just use the browser prompt directly. In this case
  // likewise run `onInstall()`.
  window.addEventListener('appinstalled', () => {
    onInstall();
  });
}