Formas alternativas de distribuir una extensión

Por lo general, una extensión de Microsoft Edge se distribuye publicándola en complementos de Microsoft Edge. Hay algunos escenarios en los que es posible que necesite distribuir una extensión mediante métodos alternativos. Por ejemplo:

1. La extensión está asociada a otro software, y debe instalarse junto con el resto del software incluido.

2. Los administradores de red quieren distribuir una extensión en toda su organización.

Las extensiones que no se cargan desde complementos de Microsoft Edge se denominan extensiones instaladas externamente. A continuación se muestran métodos alternativos de distribución de extensiones instaladas externamente:

• Use el Registro de Windows (solo Windows).
• Use un archivo JSON de preferencias (macOS y Linux).

Estos enfoques se describen a continuación.

Vea también:

• Establecer una extensión instalada externamente para actualizarse automáticamente

Recopilación de información inicial

Asegúrese de publicar la extensión en complementos de Microsoft Edge o empaquetar un .crx archivo y asegúrese de que se instala correctamente en el equipo. Si instala el .crx archivo mediante update_url, asegúrese de que puede ir a la extensión en esa dirección URL.

Además, asegúrese de que tiene la siguiente información:

• Ruta de acceso del .crx archivo o de la update_url extensión.

• La versión de la extensión. La información de versión está disponible en el archivo de manifiesto o en Microsoft Edge después edge://extensions de cargar la extensión empaquetada.

• Identificador de la extensión. La información de identificador está disponible en Microsoft Edge después edge://extensions de cargar la extensión empaquetada.

En los ejemplos siguientes se usa 1.0 como versión y aaaaaaaabbbbbbbbccccccccdddddddd para el identificador. Este identificador es el identificador CRX, que es un código único de 32 caracteres que son las letras que están presentes al final de la dirección URL de la extensión. Este identificador se genera automáticamente y no se puede personalizar.

Uso del Registro de Windows (solo Windows)

Para distribuir la extensión mediante el Registro de Windows:

1. Busque o cree la siguiente clave en el Registro:

   • Windows de 32 bits: HKEY_LOCAL_MACHINE\Software\Microsoft\Edge\Extensions
   • Windows de 64 bits: HKEY_LOCAL_MACHINE\Software\Wow6432Node\Microsoft\Edge\Extensions

2. Cree una nueva clave o carpeta en Extensiones con el mismo nombre que el identificador de la extensión. Por ejemplo, cree la clave con el nombre aaaaaaaabbbbbbbbccccccccdddddddd.

3. En la clave Extensiones , cree la update_url propiedad y establezca el valor https://edge.microsoft.com/extensionwebstorebase/v1/crxen . La update_url propiedad apunta al archivo de la .crx extensión en complementos de Microsoft Edge.

   {
       "update_url": "https://edge.microsoft.com/extensionwebstorebase/v1/crx"
   }
   

   Si desea instalar una extensión desde Chrome Web Store, establezca el valor de update_url en https://clients2.google.com/service/update2/crx.

4. En Microsoft Edge, vaya a edge://extensionsy compruebe que aparece la extensión.

Uso de un archivo JSON de preferencias (macOS y Linux)

Para distribuir la extensión mediante un archivo JSON de preferencias:

1. Al usar Linux, asegúrese de que el .crx archivo de extensión está disponible en el equipo en el que se instalará la extensión. Copie el .crx archivo de extensión en un directorio local o use un recurso compartido de red al que se pueda acceder desde la máquina.

2. Cree un archivo JSON donde el nombre del archivo se corresponda con el identificador de la extensión. Por ejemplo, cree un archivo JSON con el nombre aaaaaaaabbbbbbbbccccccccdddddddd.jsonde archivo .

   El nombre del archivo JSON de preferencias es el identificador CRX de la extensión de Microsoft Edge, seguido de una .json extensión. El id. CRX es un código único de 32 caracteres que son las letras que están presentes al final de la dirección URL de la extensión. Este identificador se genera automáticamente y no se puede personalizar.

3. En función del sistema operativo, guarde el archivo JSON en una de las carpetas siguientes:

   • macOS

     • Específico del usuario: ~USERNAME/Library/Application Support/Microsoft Edge/External Extensions/
     • Para todos los usuarios: /Library/Application Support/Microsoft/Edge/External Extensions/

     Para evitar que los usuarios no autorizados instalen extensiones para todos los usuarios, asegúrese de que el archivo de preferencias de extensión sea de solo lectura.

     Asegúrese también de que se cumplen las condiciones siguientes:

     • Cada directorio de la ruta de acceso es propiedad de la raíz del usuario.
     • Cada directorio de la ruta de acceso se asigna al admin grupo o wheel .
     • No se world pueden escribir todos los directorios de la ruta de acceso.
     • La ruta de acceso debe estar libre de vínculos simbólicos.

   • Linux

     • Específico del usuario: ~/.config/microsoft-edge/External Extensions/
     • Para todos los usuarios: /usr/share/microsoft-edge/extensions/

4. En función del escenario, copie el código adecuado que sigue en el archivo JSON de preferencias.

   • Solo se aplica a Linux. Si instala desde un archivo, especifique la ubicación y la versión en external_crx y external_version:

     {
        "external_crx": "/home/share/extension.crx",
        "external_version": "1.0"
     }
     

   • Se aplica a macOS y Linux. Si instala desde , update_urlespecifique la dirección URL de actualización en external_update_url.

     Copie el código siguiente en el archivo JSON de preferencias al instalar desde archivos locales .crx solo en Linux:

     {
        "external_update_url": "http://myhost.com/mytestextension/updates.xml"
     }
     

   • Copie el código siguiente en el archivo JSON de preferencias al instalar desde complementos de Microsoft Edge en macOS y Linux:

     {
        "external_update_url": "https://edge.microsoft.com/extensionwebstorebase/v1/crx"
     }
     

5. Para instalar extensiones para configuraciones regionales específicas, enumere las configuraciones regionales admitidas en supported_locales.

   Puede especificar configuraciones regionales primarias para instalar la extensión para todas las configuraciones regionales de idioma que usan ese elemento primario. Por ejemplo, al usar la configuración enregional primaria , la extensión se instala para todas las configuraciones regionales en inglés, como en-US, en-GB, etc. Cuando los usuarios cambian la configuración regional en su explorador, se desinstalan las extensiones instaladas externamente. Para instalar la extensión para cualquier configuración regional, no use supported_locales.

   {
      "external_update_url": "https://edge.microsoft.com/extensionwebstorebase/v1/crx",
      "supported_locales": [ "en", "fr", "de" ]
   }
   

6. Compruebe que la extensión está instalada en Microsoft Edge; para ello, vaya a edge://extensions.

Actualización y desinstalación de extensiones instaladas externamente

Microsoft Edge examina las entradas de metadatos en el Registro cada vez que se inicia el explorador y realiza cualquier cambio en las extensiones instaladas externamente.

Para actualizar la extensión a una nueva versión, actualice la version cadena en el archivo de manifiesto de extensión y, a continuación, actualice la versión en el Registro.

Es posible que tenga que desinstalar las extensiones instaladas externamente, que se instalaron como parte de un paquete de software que se instaló anteriormente en el equipo. Para desinstalar la extensión, quite el archivo JSON de preferencias o quite la clave del registro.

Vea también:

• Establecer una extensión instalada externamente para actualizarse automáticamente
• Formato de archivo de manifiesto para extensiones

Bloqueo de extensiones

Las directivas para ExtensionInstallForcelist, la lista de bloques y ExtensionSettings se usan cuando las empresas quieren instalar o bloquear extensiones específicas en las máquinas cliente. Las extensiones y su origen configurados en ExtensionInstallForcelist, ExtensionInstallSources o ExtensionSettings tienen prioridad sobre BlockExternalExtensions.

Si la BlockExternalExtensions directiva está establecida en Not Configured o Disabled, no tiene ningún efecto. Si la BlockExternalExtensions directiva está establecida en Enabled, se impide la instalación de extensiones externas (por software de terceros).

Vea también

• Establecer una extensión instalada externamente para actualizarse automáticamente
• Formato de archivo de manifiesto para extensiones

Documentos de Microsoft Edge Enterprise:

• Microsoft Edge: directivas
  • ExtensionInstallForcelist
  • ExtensionInstallSources
  • ExtensionSettings
  • BlockExternalExtensions

Esta obra está licenciada bajo una Licencia Internacional Creative Commons Attribution 4.0.