Lineamientos de advertencia de permisos

Las extensiones de Chrome mejoran la experiencia del usuario del navegador. Para ello, utiliza las APIs de Chrome que requieren ciertos permisos. Algunos permisos son menos intrusivos y no muestran una advertencia. Otros permisos activan una advertencia que los usuarios deben permitir. En esta página, se proporcionan lineamientos para trabajar con advertencias de permisos. Las advertencias específicas se indican en Permisos, debajo del permiso al que se aplican.

Figura 1: Diálogo de advertencias de permisos que se muestra durante la instalación

Cuando se agrega un permiso nuevo que activa una advertencia, la extensión se inhabilita hasta que el usuario acepta el nuevo permiso. Consulta Actualiza los permisos para aprender a probar este comportamiento.

Figura 2: Una extensión que se inhabilita hasta que el usuario acepta el nuevo permiso.

Es posible que algunos permisos no muestren advertencias cuando se vinculan con otros permisos. Por ejemplo, la advertencia "tabs" no se mostrará si la extensión también solicita "<all_urls>".

Prácticas recomendadas

Las advertencias de permisos describen las capacidades que otorga una API, pero algunas advertencias son más difíciles de entender que otras. Es más probable que los usuarios instalen extensiones que sigan estos lineamientos:

Solicita los permisos relevantes

Las extensiones son necesarias para cumplir con un único propósito y satisfacer la política de Uso de permisos. Asegúrate de solicitar solo permisos que admitan la funcionalidad principal de la extensión.

Usa permisos opcionales

Mejora la experiencia de integración mediante la solicitud de permisos durante el tiempo de ejecución. Esto te permite proporcionar más contexto sobre un permiso en particular y permite que los usuarios elijan las funciones que desean habilitar. Consulta la API de Permissions para ver los detalles de la implementación.

Cómo usar el permiso "activeTab"

Este permiso no muestra una advertencia de permiso. Otorga permiso de host temporal al sitio en el que se encuentra el usuario. Para obtener más información, consulta Información sobre el permiso activeTab.

Ver advertencias

Para ver las advertencias de permisos de una extensión, tienes las siguientes opciones:

Usa la herramienta de prueba de actualización de extensiones

Antes de comenzar

1. Instala Node.js y NPM.
2. Instala Chromium.
3. Clona el repositorio extension-update-testing-tool.
4. Ejecuta npm install en la raíz del repositorio.

Cómo utilizar la herramienta

1. Ejecuta npm start.
2. Abre el servidor local en http://localhost:8080 en Chromium.
3. Arrastra una extensión sin empaquetar (carpeta o archivo ZIP) a la página.
4. Sigue las instrucciones que se indican en "Instalar manualmente" para descargar e instalar la extensión.

Empaqueta la extensión manualmente

1. Navega hacia chrome://extensions.
2. Habilitar el modo de desarrollador
3. Haz clic en Empaquetar extensión.

   

   Figura 3: Modo de desarrollador habilitado en la página Administración de extensiones

4. Especifica la ruta de acceso a la carpeta de la extensión en el campo del directorio raíz de la extensión. Ignora el campo Clave privada para un paquete nuevo.

5. Haz clic en el botón Empaquetar extensión.

   

   Figura 4: Cómo especificar la ruta de acceso de la extensión

6. Chrome creará dos archivos: uno .crx y otro .pem. El archivo .pem contiene la clave privada que se usa para firmar la extensión. Asegúrate de recordar qué directorio se guardaron estos archivos.

   

   Figura 5: Archivos de extensión empaquetados

7. Guarda el archivo .pem en un lugar secreto y seguro, ya que será necesario para actualizar la extensión.

8. Para instalar el archivo .crx, suéltalo en la página Administración de extensiones.

   

   Figura 6: Suelta el archivo para instalarlo.

9. Después de soltar el archivo .crx, el navegador te preguntará si se puede agregar la extensión y mostrará advertencias.

   

   Figura 7: Advertencia para la extensión Nueva pestaña

Actualizar permisos

Cuando una extensión agrega un permiso nuevo que activa una advertencia, puede inhabilitarlo temporalmente. La extensión se volverá a habilitar solo después de que el usuario acepte aceptar el permiso nuevo.

Para comprobar si tu extensión se inhabilitará cuando agregues un permiso nuevo, tienes las siguientes opciones:

Realiza la actualización con la Herramienta de prueba de actualización de extensiones

En estos pasos, se da por sentado que seguiste las instrucciones de la Herramienta de prueba de actualización de extensiones para iniciar el servidor.

Cómo utilizar la herramienta

1. Agrega un permiso con advertencia nuevo.
2. Aumenta el número de versión de la extensión.
3. Arrastra la extensión desempaquetada (carpeta o archivo ZIP) a la página.
4. Ve a chrome://extensions.
5. Haz clic en el botón Actualizar.

Actualiza tu extensión manualmente

1. Busca el archivo .crx que acabas de crear en Ver advertencias.
2. Cámbiale el nombre o bórralo.
3. Abre tu manifest.json y agrega cualquier permiso que active una advertencia.
4. Ve a chrome://extensions. No quites el paquete instalado previamente.
5. Vuelve a empaquetar la extensión, pero esta vez agrega el archivo pem en la segunda entrada.

   

   Figura 8: Diálogo de extensión del empaquetado con archivo PEM incluido

6. Arrastra la nueva extensión empaquetada a la página Administración de extensiones.

7. Verás un diálogo que le solicita al usuario que acepte los nuevos permisos.

   

   Figura 9: Advertencia de extensión inhabilitada

   

   Figura 10: Diálogo de solicitud de un nuevo permiso