---
title: Implementación de páginas de inicio personalizadas | Microsoft Docs
description: Obtenga información sobre cómo implementar páginas de inicio personalizadas mediante la implementación de VSIX o copiando los archivos en las ubicaciones correctas del equipo de destino.
ms.custom: SEO-VS-2020
ms.date: 11/04/2016
ms.topic: conceptual
helpviewer_keywords:
- package start page
- deploy start page
ms.assetid: 4a7eb360-de83-41d5-be53-3cfb160d19f9
author: leslierichardson95
ms.author: lerich
manager: jmartens
ms.technology: vs-ide-sdk
ms.workload:
- vssdk
monikerRange: vs-2017
ms.openlocfilehash: 07b757ab200bb3439fb82224ea1c20e3edb8ea16
ms.sourcegitcommit: 68897da7d74c31ae1ebf5d47c7b5ddc9b108265b
ms.translationtype: MT
ms.contentlocale: es-ES
ms.lasthandoff: 08/13/2021
ms.locfileid: "122070387"
---
# <a name="deploy-custom-start-pages"></a>Implementación de páginas de inicio personalizadas
Puede implementar páginas de inicio personalizadas mediante la implementación de VSIX o copiando los archivos en las ubicaciones correctas del equipo de destino.
## <a name="vsix-deployment-by-using-the-start-page-project-template"></a>Implementación de VSIX mediante la plantilla de proyecto página de inicio
Al crear una página de inicio mediante la plantilla de proyecto Página de inicio y, a continuación, compilar el proyecto, Visual Studio crea un *archivo .vsix* que puede distribuir. El empaquetado de una página de inicio en un archivo *.vsix* ofrece las siguientes opciones de implementación, en función de la audiencia prevista:
- Puede colocar el archivo *.vsix* en un recurso compartido de red o en un sitio web público. Cuando alguien abre el archivo, la página de inicio se instala automáticamente.
- Puede cargar el archivo *.vsix* en el sitio web de [Visual Studio Marketplace](https://marketplace.visualstudio.com/) para que los usuarios puedan instalarlo mediante **el Administrador de extensiones**.
La plantilla de proyecto Página de inicio crea una copia del Visual Studio página de inicio para que pueda modificar la copia y conservar la original.
Puede obtener la plantilla de proyecto página de inicio mediante **el Administrador de extensiones** o descargándose desde el sitio web.
## <a name="vsix-deployment-without-using-the-start-page-project-template"></a>Implementación de VSIX sin usar la plantilla de proyecto página de inicio
 Una implementación de VSIX correcta requiere que se instale una extensión en carpetas reconocidas por el proceso de registro de VSIX y por **el Administrador de extensiones**. Dado que la plantilla de proyecto Página de inicio ya especifica las carpetas correctas, se recomienda usarla siempre que quiera empaquetar una extensión para la implementación de VSIX. Sin embargo, si tiene un caso en el que no puede usar la plantilla, puede crear una implementación de VSIX sin usarla.
 Para crear una implementación de VSIX sin usar la plantilla de proyecto página de inicio, cree primero un archivo *.vsix* para la página de inicio de cualquiera de estas dos maneras:
- Agregando los archivos de página de inicio personalizados a un archivo VSIX Project. Para obtener más información, consulte [Plantilla de proyecto VSIX](../extensibility/vsix-project-template.md).
- Mediante la creación manual de *un archivo .vsix.* Para crear manualmente *un archivo .vsix:*
   1. Cree el *archivo extension.vsixmanifest* y el *archivo [Content_Types].xml* en una carpeta nueva. Para obtener más información, vea [Anatomía de un paquete VSIX.](../extensibility/anatomy-of-a-vsix-package.md)
   2. En Windows, haga clic con el botón derecho en la carpeta que contiene los dos archivos XML, haga clic en Enviar a y, a continuación, haga clic en Carpeta comprimida (comprimida). Cambie el nombre *.zip* archivo resultante a *Filename.vsix,* donde Nombre de archivo es el nombre del archivo redistribuible que instala el paquete.
Para Visual Studio reconocer una página de inicio, el del manifiesto VSIX debe contener un que tenga el `Content Element` `CustomExtension Element` atributo establecido en `Type` `"StartPage"` . Una extensión de página de inicio que se ha  instalado mediante la  implementación de VSIX aparece en la lista Personalizar página de inicio de la página opciones de inicio como **[Extensión instalada]** *Nombre de extensión*.
Si el paquete de la página de inicio incluye ensamblados, debe agregar el registro de ruta de acceso de enlace para que estén disponibles cuando Visual Studio inicio. Para ello, asegúrese de que el paquete incluye un *archivo .pkgdef* que tiene la siguiente información.
```
[$RootKey$\BindingPaths\{Insert a new GUID here}]
"$PackageFolder$"=""
```
### <a name="vsix-deployment-for-all-users"></a>Implementación de VSIX para todos los usuarios
 De forma predeterminada, las extensiones implementadas en paquetes VSIX solo se instalan para el usuario actual. Puede realizar una instalación de página de inicio para todos los usuarios de la máquina de destino mediante la creación de All-Users implementación.
### <a name="to-create-an-all-users-deployment"></a>Para crear una implementación All-Users implementación
1. Abra el *archivo extension.vsixmanifest* en la vista de código.
2. En el `Identifier` elemento del manifiesto de vsix, agregue un elemento que tenga un valor de `AllUsers` `true` .
    ```
    <AllUsers>true</AllUsers>
    ```
     Esto hace que el instalador de vsix solicite permisos de administrador y, a continuación, instale los archivos en *\Common7\IDE\Extensions*.
3. Abra el *archivo .pkgdef.*
4. Modifique *el archivo .pkgdef* para establecer la página de inicio predeterminada en HKLM agregando lo siguiente, donde *MyStartPage.xaml* es el nombre del archivo *.xaml* que contiene la página de inicio.
     [$RootKey$\StartPage\Default]
     "Uri"="$PackageFolder$ \\ *MyStartPage.xaml*"
     Esto indica Visual Studio buscar en la nueva ubicación de la página de inicio.
## <a name="file-copy-deployment"></a>Implementación de copia de archivos
 No es necesario crear un archivo *.vsix* para implementar una página de inicio personalizada. En su lugar, puede copiar el marcado y los archivos de soporte técnico directamente en la <em>carpeta \StartPages del \* usuario. La *</em> lista ** Personalizar  página de inicio de la página opciones de inicio muestra todos los archivos *.xaml* de esa carpeta, junto con la ruta de acceso, por ejemplo, *%USERPROFILE%\Mis documentos\Visual Studio {version}\StartPages \\ {Nombre de archivo}.xaml.* Si la página de inicio incluye referencias a ensamblados privados, debe copiarlos y pegarlos en la carpeta *\PrivateAssemblies. \*
 Para distribuir una página de inicio que creó sin empaquetar en un archivo *.vsix,* se recomienda usar una estrategia básica de copia de archivos, por ejemplo, un script por lotes o cualquier otra tecnología de implementación que le permita colocar los archivos en los directorios necesarios.
### <a name="to-manually-install-a-custom-start-page"></a>Para instalar manualmente una página de inicio personalizada
1. Copie el *archivo .xaml* que contiene el marcado de página de inicio, junto con los archivos compatibles que no son ensamblados, y péguelos en la carpeta *\StartPages del \* usuario.
2. Si la página de inicio requiere ensamblados, cópielos y péguelos en *. \\ {Visual Studio carpeta de \\ instalación}\Common7\IDE\PrivateAssemblies*.
3. En la **lista Personalizar página de** inicio de la página **Opciones** de inicio, seleccione la nueva página de inicio. Para obtener más información, vea [Personalizar la página de inicio](../ide/customizing-the-start-page-for-visual-studio.md).
## <a name="see-also"></a>Vea también
- [Personalización de la página de inicio](../ide/customizing-the-start-page-for-visual-studio.md)
- [Agregar control de usuario a la página de inicio](../extensibility/adding-user-control-to-the-start-page.md)