SharePoint: creazione di pacchetti e distribuzione

In questo capitolo tratteremo la creazione di pacchetti e la distribuzione della soluzione SharePoint. Il primo passaggio nella distribuzione di una soluzione SharePoint è la creazione di un pacchetto della soluzione.

UN Solution Package è un CAB file con estensione WSP, che contiene tutti i file necessari per implementare le funzionalità nel progetto Visual Studio.

I file necessari per implementare le funzionalità includono:

  • Il manifesto della funzionalità.

  • Qualsiasi elemento si manifesta.

  • La dll, che contiene il codice gestito compilato.

  • File associati come pagine Web, controlli utente e file associati al Web.

  • Un altro file contenuto nel pacchetto della soluzione è il manifesto della soluzione. Il manifesto della soluzione è un catalogo dei file contenuti nel pacchetto. Per le soluzioni Farm, contiene anche le istruzioni di distribuzione.

  • Proprio come con il manifesto delle funzionalità, Visual Studio crea e gestisce automaticamente il manifesto della soluzione durante la modifica del progetto. È possibile visualizzare il manifesto della soluzione utilizzando la finestra di progettazione della soluzione.

  • Oltre a creare e mantenere il manifesto della soluzione, Visual Studio crea automaticamente anche il pacchetto della soluzione per il nostro progetto. Lo fa dietro le quinte ogni volta che distribuisci il tuo lavoro per il debug.

  • Il pacchetto della soluzione generato viene posizionato nella stessa cartella della dll, quindi sarà la cartella bin debug o bin release. Per visualizzare il contenuto di questo file in Windows Explorer, basta cambiare l'estensione da WSP a CAB e quindi fare doppio clic sul file.

Diamo uno sguardo ad un semplice esempio in cui esamineremo i pacchetti di soluzioni associati ai progetti di soluzioni SharePoint che abbiamo creato nel capitolo precedente. Cominciamo con il progetto di caratteristiche ed elementi che abbiamo creato in precedenza.

Come saprai, nel progetto abbiamo una caratteristica, chiamata Sample. Questa caratteristica fa riferimento a tre manifesti di elementiContacts, SitePage, and Action.

Puoi anche vedere che Action ha il manifest dell'elemento, Contacts ha il suo manifest dell'elemento, SitePage ha il manifest dell'elemento e una pagina web, che fornisce questa pagina web al sito. Quindi, dovremmo aspettarci che il pacchetto della soluzione contenga il Feature manifest, i tre Element Manifests, la pagina web e anche l'assembly che viene creato quando creiamo il progetto.

Step 1 - Fare clic con il pulsante destro del mouse sul progetto in Esplora soluzioni e scegliere Apri cartella in Esplora file.

Step 2- Vai al cestino e apri la cartella Debug. Vedrai il pacchetto della soluzione.

Step 3 - Crea una copia e modifica l'estensione del file Copia da wsp a cab.

Step 4- Ora fai doppio clic sul file cab per aprirlo e vedrai i file. Vedrai il manifest delle funzionalità, tre manifest degli elementi, la pagina aspx, la dll e un file aggiuntivo, che è il manifest della soluzione.

Step 5 - In Esplora soluzioni, vedrai una cartella chiamata Pacchetto e se la espandi, vedrai un file chiamato Package.package. Fai doppio clic su quel file e vedrai il progettista della soluzione.

Questo designer sta dimostrando che attualmente è presente una sola funzionalità nella soluzione e che la funzionalità fa riferimento a tre manifesti di elementi, Contatti, Pagina del sito e Azione.

Questo designer è un editor di un documento XML proprio come il designer di funzionalità.

Il manifesto della soluzione per questo proxy è semplice. Indica solo che qui è un assembly che deve essere distribuito chiamato FeaturesandElemenest.dll e lo distribuiremo alGlobalAssemblyCache.

Indica anche che abbiamo una funzionalità con questo Manifesto delle funzionalità. Se torniamo alla funzione e guardiamo il suo manifest, indica che ci sono i tre manifest degli elementi e la nostra pagina aspx.

Distribuzione della soluzione farm

Ora che sappiamo cosa sono i pacchetti di soluzioni e cosa contengono, dobbiamo imparare a distribuirli.

Per distribuire una soluzione Farm, si fornisce il pacchetto della soluzione creato da Visual Studio all'amministratore di SharePoint. Utilizzeranno PowerShell o Amministrazione centrale o una combinazione di entrambi gli strumenti per distribuire il pacchetto.

Diamo un'occhiata alla distribuzione della soluzione Farm.

Step 1 - Vai a Funzionalità ed elementi nel progetto Visual Studio.

Questo progetto ha una caratteristica con tre elementi. Quando si distribuisce una soluzione Farm, il contenuto della soluzione viene copiato nelle cartelle di sistema di SharePoint come mostrato di seguito:

Step 2 - Ora andiamo a List Designer, quindi cambia il titolo in Contacts-Change 1 e quindi fai clic sul pulsante Salva.

Step 3- Ora vai alle proprietà del progetto e quindi seleziona SharePoint nel riquadro di sinistra. NelActive Deployment Configuration opzione, scegli l'opzione Default dall'elenco a discesa.

Step 4- In Esplora soluzioni, fai clic con il pulsante destro del mouse sul progetto e scegli Distribuisci. Una volta terminata la distribuzione, aggiorna il tuo sito e vedrai il cambiamento.