Création de packages de solution SharePoint

 

Publication: avril 2016

<_caps3a_sxs _xmlns3a_caps="http://schemas.microsoft.com/build/caps/2013/11"><_caps3a_sxstarget>Le Concepteur de packages permet de créer et de personnaliser des packages de déploiement.Vous pouvez, par exemple, ajouter des éléments de projet et des fonctionnalités SharePoint, réinitialiser le serveur IIS, définir la portée de l'activation des fonctionnalités et identifier des dépendances de fonctionnalité.Le concepteur génère également un manifeste, c'est-à-dire un fichier XML ayant pour but de décrire chaque package.Outils d'empaquetageServez-vous du Concepteur de packages pour personnaliser le package et générer le manifeste.Vous pouvez inclure des éléments de projet SharePoint, préciser si le serveur Web doit être réinitialisé ou non et définir le type de serveur de déploiement.Pour plus d'informations, consultez How to: Add and Remove Features to a Package by Using the Package Designer.Vous pouvez également faire appel à l'Explorateur de package pour modifier les fonctionnalités et les éléments dans votre fichier de package (.wsp).Pour plus d'informations, consultez How to: Add and Remove Features to a Package by Using the Packaging Explorer.Vous pouvez utiliser Visual Studio et MSBuild pour créer des fichiers de package (.wsp) en vue de déployer votre solution SharePoint.Ce processus génère les fichiers manifeste nécessaires au déploiement de SharePoint.Pour plus d’informations, consultez How to: Create a SharePoint Package et How to: Create a SharePoint Package by Using MSBuild Tasks.Options du Concepteur de packagesLe tableau suivant présente les propriétés qu'il est possible de personnaliser dans les packages SharePoint au moyen du Concepteur de packages.Propriété du Concepteur de packagesDescription du paramètre par défautNomRequis.Le nom donné par défaut au package est ProjectName.Réinitialiser le serveur WebOptionnel.Sélectionnez cette propriété si vous avez l'intention de redémarrer le serveur Web après avoir installé le fichier .wsp sur le serveur SharePoint.Type de serveur de déploiementRequis.Par défaut, la portée correspond à ApplicationServer.OptionDescription ApplicationServerDécrit un serveur qui héberge des services.WebFrontEndDécrit un serveur qui héberge des sites Web.Éléments dans la solutionEnsemble des éléments de projet et des fonctionnalités SharePoint susceptibles d'être ajoutés au package.Éléments dans le packageOptionnel.Ensemble des éléments et des fonctionnalités SharePoint que vous souhaitez déployer dans votre package.Configuration du processus d'empaquetageAprès avoir développé des solutions SharePoint dans Visual Studio, vous avez la possibilité de personnaliser le mode d'empaquetage des projets.Le tableau suivant présente les deux cibles MSBuild que vous pouvez utiliser pour définir la façon dont le fichier .wsp est créé.CibleDescription BeforeLayoutCible chargée d'effectuer les tâches juste avant la copie des fichiers dans un répertoire intermédiaire.Vous pouvez modifier les fichiers avant de créer un fichier de package (.wsp).AfterLayoutCible chargée d'effectuer les tâches juste après la copie des fichiers dans un répertoire intermédiaire.Pour plus d'informations, consultez How to: Customize a SharePoint Package by Using MSBuild Targets.Architecture d'empaquetageLa création d'un package SharePoint (.wsp) dans Visual Studio se déroule selon les étapes suivantes.Les fonctionnalités et les packages sont validés pour s'assurer que la structure physique et sémantique du package est correcte.Les fonctionnalités, les éléments de projet et les fichiers du package sont énumérés.Les fichiers manifeste pour les packages et les fonctionnalités sont transformés afin d'inclure toutes les informations nécessaires au déploiement et à l'activation.Les jetons sont remplacés par la valeur qualifiée complète.La cible MSBuild BeforeLayout personnalisable est exécutée.Vous pouvez créer cette étape pour apporter des modifications personnelles au package avant la création du fichier .wsp.Les fichiers énumérés sont copiés dans un répertoire intermédiaire.La cible MSBuild AfterLayout personnalisable est exécutée.Vous pouvez créer cette étape pour apporter des modifications personnelles au package avant la création du fichier .wsp.Les fichiers figurant dans le répertoire intermédiaire sont ajoutés au fichier .wsp.Structure des dossiers du packageLorsque vous créez un package pour votre projet SharePoint, un fichier .wsp est créé pour vous dans le dossier SolutionFolder\bin \BuildConfiguration.Si, par exemple, votre solution se trouve dans drive:\Visual Studio 2013\Projects\ListDefinition1 et que votre configuration de génération correspond à Release, le fichier .wsp se situe dans drive:\Visual Studio 2013\Projects\ListDefinition1\bin\Release.How to: Open the Package Designer NOT IN BUILD: How to: Modify Package PropertiesHow to: Add and Remove Features to SharePoint Packages How to: Create a SharePoint Package How to: Create a SharePoint Package by Using MSBuild Tasks How to: Customize a SharePoint Package by Using MSBuild Targets <_caps3a_sxssource>By using the Package Designer, you can create and customize deployment packages.For example, you can add SharePoint project items and Features, reset the IIS server, set Feature activation scopes, and identify Feature dependencies.The designer also generates a manifest, an XML file that describes each package.Packaging ToolsYou can use the Package Designer to customize the package and generate the manifest.You can include SharePoint project items, configure whether the Web server should be reset, and set the deployment server type.For more information, see How to: Add and Remove Features to a Package by Using the Package Designer.Alternatively, you can use the Packaging Explorer to modify the Features and items in your package file (.wsp).For more information, see How to: Add and Remove Features to a Package by Using the Packaging Explorer.You can use Visual Studio and MSBuild to create package (.wsp) files to deploy your SharePoint solution.This process generates the manifest files needed for SharePoint deployment.For more information, see How to: Create a SharePoint Package and How to: Create a SharePoint Package by Using MSBuild Tasks.Package Designer OptionsThe following table shows the properties that you can customize in SharePoint packages with the Package Designer.Package Designer PropertyDescription of default settingNameRequired.The default name of the package is set to ProjectName.Reset WebServerOptional.Select if you want to restart the Web server after the .wsp file is installed on the SharePoint server.Deployment Server TypeRequired.By default, the scope is set to ApplicationServer.OptionDescriptionApplicationServerDescribes a server that hosts services.WebFrontEndDescribes a server that hosts Web sites.Items in the SolutionAll SharePoint project items and Features that can be added to the package.Items in the PackageOptional.All SharePoint items and Features that you want to deploy in your package.Configuring the Packaging ProcessAfter you develop SharePoint solutions in Visual Studio, you can customize how the projects are packaged.The following table shows the two MSBuild targets that you can use to customize how the .wsp file is created.TargetDescriptionBeforeLayoutThe target that performs tasks immediately before the files are copied to an intermediate directory.You can modify the files before creating a package file (.wsp).AfterLayoutThe target that performs tasks immediately after the files are copied to an intermediate directory.For more information, How to: Customize a SharePoint Package by Using MSBuild Targets.Packaging ArchitectureThe following steps occur when you create a SharePoint package (.wsp) in Visual Studio.The Features and packages are validated to make sure that the physical and semantic structure of the package is correct.The Features, project items, and package files in the package are enumerated.Manifest files for packages and Features are transformed to include all necessary information for deployment and activation.The tokens are replaced with the fully qualified value.The customizable BeforeLayout MSBuild target is performed.You can create this step to make any custom modifications to the package before the .wsp file is created.The enumerated files are copied to an intermediate directory.The customizable AfterLayout MSBuild target is performed.You can create this step to make any custom modifications to the package before the .wsp file is created.The files in the intermediate directory are added to the .wsp file.Package Folder StructureWhen you package your SharePoint project, a .wsp file is created for you in the SolutionFolder\bin\BuildConfiguration folder.For example, if your solution is in drive:\Visual Studio 2013\Projects\ListDefinition1 and your build configuration is set to Release, the .wsp file is located in drive:\Visual Studio 2013\Projects\ListDefinition1\bin\Release.How to: Open the Package Designer NOT IN BUILD: How to: Modify Package PropertiesHow to: Add and Remove Features to SharePoint Packages How to: Create a SharePoint Package How to: Create a SharePoint Package by Using MSBuild Tasks How to: Customize a SharePoint Package by Using MSBuild Targets
Afficher: