Partager via

Création manuelle d’une solution

  • Article

Dernière modification : mercredi 13 avril 2011

S’applique à : SharePoint Foundation 2010

Cette rubrique fournit des informations de base sur les packages de solution et sur la façon de les créer manuellement.

Important

Visual Studio comprend des outils qui simplifient (et automatisent en grande partie) la création et la configuration de packages de solution. Nous vous recommandons de recourir à ces outils. Utilisez uniquement cette rubrique si vous avez besoin d’informations de base, si vous avez besoin de modifier l’un des fichiers en dehors des outils Visual Studio (ce qui est rare) ou si vous êtes un développeur et que vous ne possédez pas Visual Studio.

Packages de solution

Un package de solution est un fichier CAB avec une extension de nom de fichier .wsp. Il comprend toujours un fichier manifeste et peut également contenir une partie ou la totalité des composants suivants :

  • Définitions de sites (onet.xml, webtemp*.xml et éventuellement default.aspx)

  • Des stratégies de sécurité d'accès

  • Modifications apportées à web.config

  • Fichiers de modèle et fichiers racine, qui peuvent inclure :

    • Pages d’application (*.aspx)

    • Ressources (*.resx)

    • Fichiers de ressources (par exemple, *.doc ou *.xls)

    • Contrôle utilisateur (*.ascx)

  • Assemblys non-SharePoint (par exemple des bibliothèques de classes managées personnalisées). Ceux-ci peuvent être déployés conjointement avec les éléments suivants :

    • Entrées de contrôle sécurisées

    • Ressources

  • Définitions des fonctionnalités avec leurs définitions et fichiers d’élément correspondants. Une fonctionnalité peut notamment comprendre ce qui suit :

    • Fichiers WebPart (*.webpart, *.dwp)

    • Instances de liste et modèles de liste

    • Types de contenu et types de champ personnalisés

    • Modèles BCS/BDC

    • Récepteurs d’événements

    • Pages de site (*.aspx)

    • Assemblys pour des composants WebPart ou d’autres classes SharePoint Foundation personnalisées. Ceux-ci peuvent être déployés conjointement avec les éléments suivants :

      • Entrées de contrôle sécurisées

      • Ressources

Les fichiers de solution ont une structure hiérarchique (un fichier manifeste se trouve à la racine), tandis que les répertoires de définitions de fonctionnalités, de ressources ou de sites sont contenus dans des sous-répertoires.

Les fichiers d’une définition de fonctionnalité ou de particulière doivent être placés dans le sous-répertoire de la définition de cette fonctionnalité ou de ce site.

Notes

La structure de répertoires à l’intérieur du fichier .wsp détermine la structure de répertoires finale sur le système de fichiers du serveur Web frontal. Mais en général, la structure de répertoires dans l’Explorateur de solutions, qui est générée par les outils de Visual Studio, ne correspond pas exactement à la structure de répertoires du serveur Web frontal.

Pour créer manuellement un package de solution, procédez comme suit :

  1. Créez un fichier manifest.xml de solution

    Le fichier manifeste de solution (toujours appelé manifest.xml) est stocké à la racine d’un fichier de solution. Ce fichier définit la liste des fonctionnalités, des définitions de site, des fichiers de ressources, des fichiers de composant WebPart et des assemblys à traiter. Il ne définit pas la structure de fichiers ; si des fichiers sont inclus dans une solution, mais qu’ils ne sont pas répertoriés dans le fichier manifeste XML, ils ne sont pas traités.

    La structure ci-dessous illustre la structure d’un fichier manifest.xml.

    <Solution SolutionId="4AFC1350-F354-4439-B941-51377E845F2B" xmlns="https://schemas.microsoft.com/sharepoint/">
  <FeatureManifests>
    <FeatureManifest Location="FeatureLibrary\feature.xml"/>
  </FeatureManifests>
  <TemplateFiles>
    <TemplateFile Location="ControlTemplates\Featurelibraryform.ascx"/>
  </TemplateFiles>
  <RootFiles> 
  <!-- These files go into the 12\ directory and can be used for Web services and global resources -->
    <RootFile Location="ISAPI\MyWebService.asmx">
  </RootFiles>
  <Assemblies>
    <Assembly  DeploymentTarget="GlobalAssemblyCache" 
Location="ms.samples.sharepoint.myFeature.dll"/>
  </Assemblies>
</Solution>

    En outre, vous pouvez ajouter un élément DwpFiles pour spécifier les fichiers .webpart ou .dwp, ou un élément ResourceFiles pour spécifier les fichiers de ressources, les définitions de site, les ressources d’application et les stratégies de sécurité d’accès au code.

  2. Si le package comprend des fonctionnalités, chacune d’entre elles possède un fichier feature.xml. Pour chaque fichier manifeste d’élément de fonctionnalité (elements.xml) dans la fonctionnalité, ajoutez une balise ElementFile qui pointe vers le manifeste d’élément de fonctionnalité.

  3. Créez le package de solution (fichier .wsp).

    Étant donné que le fichier de solution est essentiellement un fichier .cab, utilisez l’outil makecab.exe pour créer le package de solution. Cet outil prend un pointeur vers un fichier .ddf (Diamond Directive File), qui décrit la structure du fichier .cab. Le format d’un fichier .ddf est pratiquement du même style que le fichier .inf ; vous déclarez un en-tête standard, puis vous énumérez, un fichier par ligne, le jeu des fichiers en fonction de leur emplacement sur le disque, séparés en fonction de leur emplacement dans le fichier .cab.

    ;
.OPTION EXPLICIT     ; Generate errors 
.Set CabinetNameTemplate=MySolutionFile.wsp     
.set DiskDirectoryTemplate=CDROM ; All cabinets go in a single directory
.Set CompressionType=MSZIP;** All files are compressed in cabinet files
.Set UniqueFiles="ON"
.Set Cabinet=on
.Set DiskDirectory1=Package
build\manifest.xml manifest.xml
build\ MySolutionFile \feature.xml MySolutionFile \feature.xml
...

Voir aussi

Concepts

Schéma de solution

Vue d'ensemble des solutions