Extensiones de publicación

Se aplica a: Windows Admin Center, versión preliminar de Windows Admin Center

Una vez que haya desarrollado la extensión, querrá publicarla y ponerla a disposición de otros usuarios para probarla o usarla. En este artículo, presentamos algunas opciones de publicación junto con los pasos y requisitos en función de la audiencia y la finalidad de la publicación.

Opciones de publicación

Hay tres opciones principales para los orígenes de paquetes configurables que Windows Admin Center admiten:

• Fuente de NuGet pública de Windows Admin Center de Microsoft
• Su propia fuente NuGet privada
• Recurso compartido de archivos local o de red

Publicación en la fuente de extensión Windows Admin Center

De forma predeterminada, Windows Admin Center está conectado a una fuente de NuGet mantenida por el equipo de producto de Windows Admin Center en Microsoft. Se pueden publicar las versiones preliminares anteriores de las nuevas extensiones desarrolladas por Microsoft en esta fuente y ponerlas a disposición de los usuarios de Windows Admin Center. Los desarrolladores externos que planean crear y publicar extensiones también pueden enviar una solicitud para publicar la extensión en la fuente de Windows Admin Center. Antes de publicar en esta fuente, los desarrolladores externos tienen que aceptar el Contrato de publicador de extensiones y la directiva de participación de extensión de Windows Admin Center.

Publicación en una fuente de NuGet diferente

También puede crear su propia fuente de NuGet para publicar las extensiones mediante una de las muchas opciones diferentes para configurar un origen privado o usar un servicio de hospedaje de NuGet. La fuente de NuGet debe admitir la API de NuGet v2. Dado que Windows Admin Center no admite actualmente la autenticación de fuentes, la fuente debe configurarse para permitir el acceso de lectura a cualquier persona.

Publicación en un recurso compartido de archivos

Para restringir el acceso de la extensión a su organización o a un grupo limitado de personas, puede usar un recurso compartido de archivos SMB como fuente de extensión. Cuando se usa un recurso compartido de archivos para hospedar la fuente de extensiones, se aplican permisos de archivo y carpeta para administrar el acceso a la fuente.

Preparación de la extensión para la versión

Asegúrese de que lee y tiene en cuenta los siguientes artículos de desarrollo:

• Controlar la visibilidad de la herramienta
• Cadenas y localización

Considere la posibilidad de publicar como versión preliminar

Si va a publicar una versión preliminar de la extensión con fines de evaluación, le recomendamos que:

• Anexe "(Versión preliminar)" al final del título de la extensión en el archivo .nuspec
• Explique las limitaciones de la descripción de la extensión en el archivo .nuspec

Creación de un paquete de extensión

Windows Admin Center utiliza paquetes y fuentes de NuGet para distribuir y descargar extensiones. Para que el paquete se envíe, tiene que generar un paquete NuGet que contenga los complementos y extensiones. Un único paquete puede contener una extensión de interfaz de usuario y un complemento de puerta de enlace. La sección siguiente le guiará por el proceso.

Compilación de la extensión

Tan pronto como esté listo para empezar a empaquetar la extensión, cree un directorio en el sistema de archivos, abra una consola y CD en él. Este será el directorio raíz que usaremos para contener todos los directorios nuspec y content que componen nuestro paquete. Llamaremos a esta carpeta Paquete NuGet durante el resto de este artículo.

Extensiones de UI

Para comenzar el proceso de recopilación de todo el contenido necesario para una extensión de interfaz de usuario, ejecute "gulp build" en la herramienta y asegúrese de que la compilación sea correcta. Este proceso empaqueta todos los componentes en una carpeta denominada "bundle" ubicada en el directorio raíz de la extensión (en el mismo nivel del directorio src). Copie este directorio y todo lo que contiene en la carpeta "Paquete NuGet".

Complementos de puerta de enlace

Mediante la infraestructura de compilación (la cual podría ser algo tan sencillo como abrir Visual Studio y hacer clic en el botón Compilar), compile y cree el complemento. Abra el directorio de salida de la compilación y copie los archivos DLL que representan el complemento y colóquelos en una carpeta nueva dentro del directorio "Paquete NuGet" que se llame "paquete". No es necesario copiar el archivo DLL FeatureInterface, solo los archivos DLL que representan el código.

Creación del archivo nuspec

Para crear el paquete NuGet, primero debe crear un archivo .nuspec. Un archivo .nuspec es un manifiesto XML que contiene metadatos de paquete NuGet. Este manifiesto se usa para crear el paquete y para proporcionar información a los consumidores. Ponga este archivo en la raíz de la carpeta "Paquete NuGet".

Este es un archivo .nuspec de ejemplo y la lista de propiedades necesarias o recomendadas. Para obtener el esquema completo, consulte la referencia de nuspec. Guarde el archivo .nuspec en la carpeta raíz del proyecto con el nombre de archivo que prefiera.

Importante

El valor <id> del archivo .nuspec debe coincidir con el valor "name" del archivo manifest.json del proyecto o, de lo contrario, la extensión publicada no se cargará correctamente en Windows Admin Center.

<?xml version="1.0">
<package>
  <metadata>
    <id>contoso.project.extension</id>
    <version>1.0.0</version>
    <title>Contoso Hello Extension</title>
    <authors>Contoso</authors>
    <owners>Contoso</owners>
    <requireLicenseAcceptance>false</requireLicenseAcceptance>
    <projectUrl>https://msft-sme.myget.org/feed/windows-admin-center-feed/package/nuget/contoso.sme.hello-extension</projectUrl>
    <licenseUrl>http://YourLicenseLink</licenseUrl>
    <iconUrl>http://YourLogoLink</iconUrl>
    <description>Hello World extension by Contoso</description>
    <copyright>(c) Contoso. All rights reserved.</copyright>
    <tags></tags>
  </metadata>
  <files>
    <file src="bundle\**\*.*" target="ux" />
    <file src="package\**\*.*" target="gateway" />
  </files>
</package>

Propiedades obligatorias o recomendadas

Nombre de propiedad	Requerido/Recomendado	Descripción
packageType	Requerido	Use WindowsAdminCenterExtension, que es el tipo de paquete NuGet definido para las extensiones de Windows Admin Center.
ID	Requerido	Identificador de paquete único dentro de la fuente. Este valor debe coincidir con el valor "name" del archivo manifest.json del proyecto. Vea Choosing a unique package identifier (Elegir un identificador de paquete único) para obtener instrucciones.
title	Necesario para publicar en la fuente de Windows Admin Center	Nombre descriptivo del paquete que se muestra en el Administrador de extensiones de Windows Admin Center.
version	Requerido	Versión de la extensión. Se recomienda usar el control de versiones semántico (convención de SemVer), pero no es necesario.
authors	Requerido	Si publica en nombre de su empresa, use el nombre de la empresa.
description	Requerido	Proporcione una descripción de la funcionalidad de la extensión.
iconUrl	Recomendado para publicar en la fuente de Windows Admin Center	Dirección URL del icono que se va a mostrar en el Administrador de extensiones.
projectUrl	Necesario para publicar en la fuente de Windows Admin Center	Dirección URL al sitio web de la extensión. Si no tiene un sitio web independiente, use la dirección URL de la página web del paquete en la fuente NuGet.
licenseUrl	Necesario para publicar en la fuente de Windows Admin Center	Dirección URL del contrato de licencia de usuario final de la extensión.
files	Requerido	Estas dos configuraciones configuran la estructura de carpetas que Windows Admin Center espera para las extensiones de interfaz de usuario y los complementos de puerta de enlace.

Compilación del paquete NuGet de extensión

Con el archivo .nuspec que creó anteriormente, debe crear el archivo .nupkg del paquete NuGet que puede cargar y publicar en la fuente de NuGet.

1. Descargue la herramienta de la CLI de nuget.exe desde el sitio web de herramientas de cliente de NuGet.
2. Ejecute nuget.exe pack <>.nuspec file name> para crear el archivo .nupkg.

Firma del paquete NuGet de extensión

Todos los archivos .dll incluidos en la extensión deben firmarse con un certificado de una entidad de certificación de confianza. De forma predeterminada, los archivos .dll sin firmar se bloquearán cuando Windows Admin Center se ejecute en modo de producción.

Se recomienda firmar el paquete NuGet de extensión para garantizar la integridad del paquete.

Nota:

Si está planeado que la extensión admita el Control de aplicaciones de Windows Defender, el paquete y todos los archivos que contiene deben estar firmados. Más información sobre la firma con el Control de aplicaciones de Windows Defender.

Prueba del paquete NuGet de extensión

El paquete de extensión ya está listo para pruebas. Cargue el archivo .nupkg en una fuente NuGet o cópielo en un recurso compartido de archivos. Para ver y descargar paquetes de un recurso compartido de fuentes o archivos diferente, deberá cambiar la configuración de la fuente para que apunte a la fuente de NuGet o al recurso compartido de archivos. Al realizar pruebas, asegúrese de que las propiedades se muestran correctamente en el Administrador de extensiones y que puede instalar y desinstalar correctamente la extensión.

Publicación de la extensión en la fuente de Windows Admin Center

Al publicar en la fuente de Windows Admin Center, puede hacer que la extensión esté disponible para cualquier usuario de Windows Admin Center. Dado que el SDK de Windows Admin Center sigue en versión preliminar, nos gustaría colaborar con usted para resolver problemas de desarrollo y garantizar que pueda ofrecer un producto y una experiencia de calidad a los usuarios.

Antes de enviar una solicitud de revisión de extensión a Microsoft, debe enviar un correo electrónico para wacextensionrequest@microsoft.com expresar la intención de publicar una extensión en la fuente pública. Le proporcionaremos copias del Contrato de publicador de extensiones y la directiva de participación de la extensión para revisar y confirmar por escrito.

Antes de publicar la versión inicial de su extensión, le recomendamos que envíe una solicitud de revisión de la extensión a Microsoft al menos 2-3 semanas antes de su publicación. Si nos da de 2 a 3 semanas antes de la publicación, tendremos tiempo suficiente para revisarla y, si es necesario, para que pueda introducir cambios en la extensión. Una vez que su extensión esté lista para publicarse, deberá enviárnosla para que la revisemos. Si se aprueba la extensión, la publicaremos en la fuente automáticamente. Al enviar a Microsoft su paquete de extensión, acepta estar enlazado por los términos del Contrato de publicador de extensiones y la Directiva de participación de la extensión.

Después, si desea publicar una actualización en la extensión, tiene que enviar otra solicitud de revisión. En función del ámbito del cambio, el tiempo de entrega de las actualizaciones generalmente es más corto.

Enviar una solicitud de revisión de extensión a Microsoft

Para enviar una solicitud de revisión de extensión, proporcione la siguiente información y envíela por correo electrónico a wacextensionrequest@microsoft.com. Responderemos a su correo electrónico en un plazo de una semana.

Windows Admin Center: Información de solicitud de revisión de extensión:

• Nombre y dirección de correo electrónico del propietario o desarrollador de la extensión (hasta 3 usuarios). Si publica una extensión en nombre de su empresa, proporcione la dirección de correo electrónico de la empresa.
• Nombre de la empresa (solo es necesario si va a publicar una extensión en nombre de su empresa)
• Nombre de la extensión
• Objetivo de fecha de publicación (estimación)
• Para un nuevo envío de extensión: descripción de la extensión (marcos de conexión de diseño temprano, bocetos de pantalla o capturas de pantalla recomendadas del producto)
• Para una actualización de una extensión: descripción de los cambios (incluya capturas de pantalla del producto si la interfaz de usuario ha cambiado significativamente)

Envío del paquete de extensión para su revisión y publicación

Asegúrese de seguir las instrucciones anteriores para crear un paquete de extensión y compruebe que el archivo .nuspec está definido correctamente y que los archivos están firmados. También se recomienda tener un sitio web del proyecto que incluya:

• Descripción detallada de la extensión, incluidas capturas de pantalla o vídeo
• Dirección de correo electrónico o característica de sitio web para recibir comentarios o preguntas

Cuando esté listo para publicar la extensión, envíe un correo electrónico a wacextensionrequest@microsoft.com. Proporcionamos instrucciones sobre cómo enviarnos su paquete de extensión. Después de recibir el paquete, lo revisaremos. Una vez aprobado el paquete de extensión, lo publicaremos en la fuente de Windows Admin Center.