Lahendusepakkija tööriist

SolutionPackager on tööriist, mis suudab tihendatud lahendusfaili pöörduvalt mitmeks XML-failiks ja muudeks failideks jagada. Microsoft Dataverse Seejärel saate neid faile hõlpsalt hallata versioonikontrollisüsteemi abil. Järgmistes jaotistes selgitatakse, kuidas tööriista käitada ja kuidas tööriista hallatavate ja mittehallatavate lahendustega kasutada.

Oluline

Lahenduste pakkimiseks ja lahtipakkimiseks ei ole enam soovitatav tööriist SolutionPackager. SolutionPackageri tööriista võimalused on integreeritud **CLI-sse** Power Platform . Käsul pac solution on mitu tegusõna, sh unpack, pack, clone ja sync , mis sisaldavad samu SolutionPackageri tööriista alusvõimalusi.

Lahendusepakkija tööriista otsimine

Lahendusepakkija tööriista levitatakse Microsoft.CrmSdk.CoreTools NuGeti paketina. Programmi installimiseks järgige neid samme.

1. Laadige alla pakett. NuGet
2. Nimeta paketi failinime laiend ümber .nupkg-ist .zip-iks.
3. Pakkige pakitud (zip) faili sisu lahti.

Leidke SolutionPackager.exe käivitatav fail kaustast <extracted-folder-name>/contents/bin/coretools. Käivita programm kaustast coretools või lisa see kaust oma teele (PATH).

Lahendusepakkija käsurea argumendid

Lahendusepakkija on käsurea tööriist, mida saab kasutada järgmises tabelis määratletud parameetritega.

Argument	Kirjeldus
/action: {Extract|Pakett}	Nõutav. Toiming sooritamiseks. Toiming võib olla lahenduse ZIP-faili ekstraktimine kausta või kausta pakkimine ZIP-failiks.
/zipfile: <failitee>	Nõutav. Lahenduse ZIP-faili tee ja nimi. Ekstraktimisel peab fail olemas olema ja olema loetav. Pakkimisel fail asendatakse.
/folder: <kausta tee>	Nõutav. Kausta tee. Lahti pakkimisel luuakse see kaust ja täidetakse komponendi failidega. Pakkimisel peab see kaust juba olemas olema ja sisaldama varem lahti pakitud komponendi faile.
/packagetype: {Unmanaged|Managed|Mõlemad}	Valikuline. Töödeldava paketi tüüp. Vaikeväärtus on Mittehallatav. See argument võidakse enamikul juhtudel välja jätta, kuna paketi tüüpi saab lugeda ZIP-faili või komponendi failide seest. Kui lahti pakkimine ja väärtus Mõlemad on määratud, peavad hallatava ja mittehallatava lahenduse ZIP-failid olema olemas ja neid töödeldakse ühte kausta. Kui pakkimine on määratud ja „Mõlemad”, luuakse hallatava ja mittehallatava lahenduse .zip-failid ühest kaustast. Lisateavet leiate selle artikli hilisemast jaotisest hallatavate ja mittehallatavate lahendustega töötamise kohta.
/allowWrite:{Yes|Ei}	Valikuline. Vaikeväärtus on Jah. Seda argumenti kasutatakse ainult lahti pakkimisel. Kui /allowWrite:No on määratud, sooritab tööriist kõik toimingud, kuid ei saa faile kirjutada ega kustutada. Lahtipakkimise toimingut saab ohutult hinnata ilma olemasolevaid faile üle kirjutamata või kustutamata.
/allowDelete:{Yes|No|Küsi}	Valikuline. Vaikeväärtus on Küsi. Seda argumenti kasutatakse ainult lahti pakkimisel. Kui on määratud /allowDelete:Yes, kustutatakse automaatselt kõik parameetriga /folder määratud kaustas olevad ebasoovitavad failid. Kui on määratud /allowDelete:No, siis kustutamist ei toimu. Kui /allowDelete:Küsi on määratud, palutakse kasutajal konsooli kaudu lubada või keelata kõik kustutustoimingud. Kui on määratud /allowWrite:No, siis kustutamist ei toimu isegi siis, kui on määratud ka /allowDelete:Yes.
/clobber	Valikuline. Seda argumenti kasutatakse ainult lahti pakkimisel. Kui/clobber on määratud, kirjutatakse kirjutuskaitstud atribuudiga failid üle või kustutatakse. Kui seda pole määratud, siis kirjutuskaitstud atribuudiga faile üle ei kirjutata ega kustutata.
/errorlevel: {Väljas|Viga|Hoiatus|Info|Paljusõnaline}	Valikuline. Vaikeväärtus on Teave. See argument näitab teabe väljundisse logimise taset.
/map: <failitee>	Valikuline. Faili vastenduse direktiive sisaldava XML-faili tee ja nimi. Lahti pakkimisel loetakse tavaliselt parameetriga /kaust määratud kaustast loetavaid faile erinevatest asukohtadest, nagu on määratud vastendusfailis. Pakkimistoimingu ajal ei kirjutata direktiividele vastavaid faile.
/nologo	Valikuline. Keelake bänner käitusajal.
/log: <failitee>	Valikuline. Logifaili tee ja nimi. Kui fail on juba olemas, lisatakse failile uus logimisteave.
@ <failitee>	Valikuline. Tööriista käsurea argumente sisaldava faili tee ja nimi.
/sourceLoc: <string>	Valikuline. See argument loob malli ressursifaili ja kehtib ainult lahti pakkimisel. Võimalikud väärtused on auto või LCID/ISO kood selle keele jaoks, mida soovite eksportida. Selle argumendi kasutamisel pakitakse antud lokaadi stringiressursid lahti neutraalse RESX-failina. Kui on määratud auto või ainult lüliti pikk või lühike kuju, kasutatakse aluslokaati või lahendust. Saate kasutada käsu lühivormi: /src.
/lokaliseeri	Valikuline. Saate kõik stringiressursid RESX-failideks lahti pakkida või ühendada. Saate kasutada käsu lühivormi: /loc. Lokaliseerimissuvand toetab .resx failide ühiskomponente. Lisateave: RESX-i veebiressursside kasutamine

Kasutage käsu argumenti /kaart

Järgnevalt kirjeldatakse argumendi /kaart kasutamist tööriistas Lahendusepakkija.

Automatiseeritud koostesüsteemis loodud faile (nt. xap Silverlighti failid ja lisandmoodulite komplektid) ei kontrollita tavaliselt lähtekeskkonna juhtimises. Veebiressursid võivad juba olla versioonikontrollis asukohtades, mis ei ühildu otseselt SolutionPackager tööriistaga. Parameetri /kaart kaasamisega saab Lahendusepakkija tööriista suunata selliseid faile lugema ja pakkima alternatiivsetest asukohtadest, mitte kaustast Lahti pakkimine, nagu seda tavaliselt tehakse. Parameeter /map peab määrama kaardistusdirektiive sisaldava XML-faili nime ja tee. Need direktiivid annavad lahenduspaketile juhise leida failidele vasteid nime ja tee järgi ning näitavad sobiva faili leidmiseks alternatiivset asukohta. Järgnev teave kehtib kõigi direktiivide kohta võrdselt.

• Võib olla loetletud mitu direktiivi, sealhulgas need, mis vastavad identsetele failidele. Faili alguses loetletud direktiivid on hilisemates direktiivides ülimuslikud.

• Kui fail on vastendatud mis tahes direktiivile, tuleb see leida vähemalt ühest alternatiivsest asukohast. Kui sobivaid alternatiive ei leita, kuvab lahenduspakkija vea.

• Kausta ja faili teed võivad olla absoluutsed või suhtelised. Suhtelisi teid hinnatakse alati parameetriga /kaust määratud kaustast.

• Keskkonnamuutujaid saab määrata süntaksi %variable% abil.

• Kausta metamärki "**" võib kasutada tähenduses "mis tahes alamkaustas". Seda saab kasutada ainult tee viimase osana, näiteks: "c:\kaustA\**".

• Failinime metamärke võib kasutada ainult vormidena „*.ext” või „*.*”. Muud mustrit ei toetata.

  Siin kirjeldatakse kolme tüüpi direktiivide vastendusi ja näidet, mis selgitab, kuidas neid kasutada.

Kausta vastendamine

Järgnev teave annab üksikasjalikku teavet kaustade kaardistamise kohta.

XML-vorming

<Folder map="folderA" to="folderB" />

Kirjeldus

Failiteed, mis vastavad kaustale "kaustA", vahetatakse kaustaks "kaustB".

• Alamkaustade hierarhia peab täpselt kattuma.

• Kausta metamärke ei toetata.

• Faili nimesid ei saa määrata.

  Näited

  <Folder map="folderA" to="folderB" />  
  <Folder map="folderA\folderB" to="..\..\folderC\" />  
  <Folder map="WebResources\subFolder" to="%base%\WebResources" />  
  

Faili sihtkoht faili vastendamiseks

Järgnev teave annab failidevahelise vastenduse kohta lisateavet.

XML-vorming

<FileToFile map="path\filename.ext" to="path\filename.ext" />

Kirjeldus

Kõik parameetrile map vastavad failid loetakse parameetris to määratud nime ja tee alt.

Parameetri map jaoks:

• Faili nimi tuleb määrata. Tee on valikuline. Kui teed pole määratud, võidakse vastendada mis tahes kausta failid.

• Failinime metamärke ei toetata.

• Kausta metamärki toetatakse.

  Parameetri to jaoks:

• Faili nimi ja tee tuleb määrata.

• Faili nimi võib erineda parameetri map nimest.

• Failinime metamärke ei toetata.

• Kausta metamärki toetatakse.

Näited

  <FileToFile map="assembly.dll" to="c:\path\folder\assembly.dll" />  
  <FileToFile map="PluginAssemblies\**\this.dll" to="..\..\Plugins\**\that.dll" />  
  <FileToFile map="Webresrouces\ardvark.jpg" to="%SRCBASE%\CrmPackage\WebResources\JPG format\aardvark.jpg" />  

  <FileToFile
    map="pluginpackages\cr886_PluginPackageTest\package\cr886_PluginPackageTest.nupkg"
    to="myplg\bin\Debug\myplg.1.0.0.nupkg" /> 

Ülaltoodud paketi näites ei kirjutata cr886_PluginPackageTest.nupkg faili üle, kui see on määratud asukohas juba olemas. NuGet

Fail tee vastendamiseks

Järgnevalt antakse üksikasjalikku teavet fail-teeks vastendamise kohta.

XML-vorming

<FileToPath map="path\filename.ext" to="path" />

Kirjeldus

Kõiki parameetrile map vastavaid faile loetakse parameetris to määratud tee järgi.

Parameetri map jaoks:

• Faili nimi tuleb määrata. Tee on valikuline. Kui teed pole määratud, võidakse vastendada mis tahes kausta failid.

• Faili nime metamärke toetatakse.

• Kausta metamärki toetatakse.

Parameetri to jaoks:

• Tee tuleb määrata.

• Kausta metamärki toetatakse.

• Faili nime ei tohi määrata.

  Näited

  <FileToPath map="assembly.dll" to="c:\path\folder" />  
  <FileToPath map="PluginAssemblies\**\this.dll" to="..\..\Plugins\bin\**" />  
  <FileToPath map="*.jpg" to="%SRCBASE%\CrmPackage\WebResources\JPG format\" />  
  <FileToPath map="*.*" to="..\..\%ARCH%\%TYPE%\drop" />  

Vastendamise näide

Järgmises XML-koodi näites kuvatakse täielik vastendusfail, mis võimaldab Lahendusepakkija tööriistal lugeda kõiki veebiressursse ja kahte vaikimisi loodud komplekti arendustööriistakomplekti projektist nimega CRMDevTookitSample.

<?xml version="1.0" encoding="utf-8"?>  
<Mapping>  
       <!-- Match specific named files to an alternate folder -->  
       <FileToFile map="CRMDevTookitSamplePlugins.dll" to="..\..\Plugins\bin\**\CRMDevTookitSample.plugins.dll" />  
       <FileToFile map="CRMDevTookitSampleWorkflow.dll" to="..\..\Workflow\bin\**\CRMDevTookitSample.Workflow.dll" />  
       <!-- Match any file in and under WebResources to an alternate set of subfolders -->  
       <FileToPath map="WebResources\*.*" to="..\..\CrmPackage\WebResources\**" />  
       <FileToPath map="WebResources\**\*.*" to="..\..\CrmPackage\WebResources\**" />  
</Mapping>  

Hallatavad ja mittehallatavad lahendused

Dataverse'i tihendatud lahenduse (.zip) faili saab eksportida ühte kahest tüübist, nagu siin näidatud.

Hallatud lahendus
Lõpetatud lahendus, mis on organisatsiooni importimiseks valmis. Pärast importimist ei saa komponente lisada ega eemaldada, kuigi soovi korral saab neid edaspidi kohandada. See on soovitatav, kui lahenduse arendamine on lõpule jõudnud.

Haldamata lahendus
Avatud lahendus, mis ei piira lisamise, eemaldamise ega muutmise võimalusi. See on lahenduse arendamisel soovitatav.

Tihendatud lahendusefaili vorming on selle tüübi põhjal erinev, kas hallatav või mittehallatav. Lahendusepakkija saab töödelda mõlemat tüüpi tihendatud lahendusefaile. Kuid tööriist ei saa teisendada ühte tüüpi teiseks. Ainus viis lahendusefailide teisendamiseks muuks tüübiks (nt mittehallatavast tüübist hallatavaks tüübiks) on importida mittehallatav lahenduse ZIP-fail Dataverse'i serverisse ja seejärel eksportida lahendus hallatava lahendusena.

Lahendusepakkija saab töödelda mittehallatavaid ja hallatavaid lahenduse ZIP-faile kombineeritud komplektina parameetri /PaketiTüüp:Mõlemad kaudu. Selle toimingu sooritamiseks tuleb teie lahendus eksportida kaks korda iga tüübina, nimetades ZIP-failid järgmiselt.

Mittehallatav ZIP-fail: MisTahesNimi.zip	Hallatav ZIP-fail: MisTahesNimi_hallatav.zip

Tööriist eeldab, et hallatav ZIP-fail on mittehallatava failiga samas kaustas ja pakib mõlemad failid lahti ühte kausta, säilitades hallatavate ja mittehallatavate komponentide erinevused.

Kui lahendus on pakitud lahti nii mittehallatava kui ka hallatava lahendusena, saab sellest ühest kaustast pakkida mõlemad tüübid või iga tüübi eraldi, kasutades parameetrit /PaketiTüüp, et määrata, millist tüüpi luua. Mõlema faili määramisel luuakse kaks .zip-faili, kasutades ülaltoodud nimetamiskonventsiooni. Kui kahest hallatavast ja mittehallatavast kaustast pakkimisel puudub parameeter /PaketiTüüp, luuakse vaikimisi üks mittehallatav ZIP-fail.

Tõrkeotsing

Kui kasutate Lahendusepakkija loodud ressursifailide redigeerimiseks Visual Studiot, võite saada uuesti pakkimisel järgmise või sarnase teate: “Failed to determine version id of the resource file <filename>.resx the resource file must be exported from the solutionpackager.exe tool in order to be used as part of the pack process.” (Ressursifaili .resx versiooni ID määramine nurjus. Ressursifail tuleb solutionpackager.exe tööriistast eksportida, et seda saaks kasutada pakkimisprotsessi osana.). See juhtub seetõttu, et Visual Studio asendab ressursifaili metaandmete sildid andmete siltidega.

Lahendus

1. Avage ressursifail oma lemmiktekstiredaktoris ning otsige üles ja värskendage järgmisi silte:

   <data name="Source LCID" xml:space="preserve">  
   <data name="Source file" xml:space="preserve">  
   <data name="Source package type" xml:space="preserve">  
   <data name="SolutionPackager Version" mimetype="application/x-microsoft.net.object.binary.base64">  
   
   

2. Muutke sõlme nimi <data> nimeks <metadata>.

   Näiteks see string:

   <data name="Source LCID" xml:space="preserve">  
     <value>1033</value>  
   </data>  
   
   

   Muudetud:

   <metadata name="Source LCID" xml:space="preserve">  
     <value>1033</value>  
   </metadata>  
   
   

   See võimaldab Lahenduspakkijal ressursifaili lugeda ja importida. Seda probleemi jälgitakse ainult Visual Studio ressursi redaktori kasutamisel.

Vt ka

Versioonikontrolli kasutamine lahendusfailidega
Lahenduskontseptsioonid