Partekatu honen bidez:

SolutionPackager tresna

  • Artikulua

SolutionPackager Microsoft Dataverse konprimitutako soluzio-fitxategi bat modu itzulgarrian deskonposatu dezakeen tresna bat da, XML fitxategi eta beste hainbat fitxategitan. Ondoren, fitxategi hauek erraz kudea ditzakezu iturburu-kontrol-sistema bat erabiliz. Hurrengo ataletan tresna nola exekutatu eta nola erabili kudeatu eta kudeatu gabeko irtenbideekin erakusten da.

Garrantzitsua da

SolutionPackager tresna jada ez da soluzioak deskonpaktatzeko eta ontziratzeko modu gomendatua. SolutionPackager tresnaren gaitasunak Power Platform CLI-n sartu dira. pac solution Komandoak hainbat aditz ditu, besteak beste, unpack, pack, clone eta sync hori barne hartzen dutenak. SolutionPackager tresnaren azpiko gaitasun berdinak.

Non aurkitu SolutionPackager tresna

SolutionPackager tresna Microsoft.CrmSdk.CoreTools NuGet paketearen zati gisa banatzen da. Programa instalatzeko, jarraitu urrats hauek.

  1. Deskargatu NuGet paketea.
  2. Aldatu izena paketearen fitxategi-izenaren luzapena .nupkg-tik .zip-era.
  3. Atera konprimitutako (zip) fitxategiaren edukia.

Bilatu SolutionPackager.exe exekutagarria <extract-folder-name>/contents/bin/coretools karpetan. Exekutatu programa coretools karpetatik edo gehitu karpeta hori zure PATH-era.

SolutionPackager komando lerroko argumentuak

SolutionPackager komando lerroko tresna bat da, hurrengo taulan identifikatutako parametroekin deika daitekeena.

Argumentua Deskribapenak
/action: {Extract|Paketea} Beharrezkoa. Egiteko ekintza. Ekintza izan daiteke .zip irtenbide bat karpeta batera ateratzea edo karpeta .zip fitxategi batean biltzea.
/zipfile: <fitxategiaren bidea> Beharrezkoa. .Zip fitxategi baten bidea eta izena. Ateratzerakoan, fitxategiak existitu eta irakurgarria izan behar du. Paketatzerakoan, fitxategia ordezkatuko da.
/karpeta: <karpetaren bidea> Beharrezkoa. Karpeta baten bidea. Ateratzean, karpeta hau osagai-fitxategiekin sortu eta populatzen da. Paketatzerakoan, karpeta hau lehendik egon behar du eta aurretik ateratako osagai fitxategiak eduki behar ditu.
/packagetype: {Unmanaged|Managed|Biak} Aukerakoa. Prozesatzeko pakete mota. Balio lehenetsia Kudeatu gabea da. Argumentu hau gehienetan uka daiteke pakete mota .zip fitxategiaren edo osagai fitxategien barruan irakur daitekeelako. Bi eta ateratzean zehazten denean, .zip fitxategiak kudeatu eta kudeatu gabeko irtenbidea egon behar du eta karpeta bakarrean prozesatu. Paketatzea eta Biak zehazten direnean, kudeatutako eta kudeatu gabeko irtenbide .zip fitxategiak karpeta batetik sortzen dira. Informazio gehiago lortzeko, ikusi kudeatutako eta kudeatu gabeko soluzioekin lan egiteari buruzko atala artikulu honetan.
/allowWrite:{Yes|Ez} Aukerakoa. Balio lehenetsia Bai da. Argudio hau erauzketa batean bakarrik erabiltzen da. Noiz / allowWrite: Ez da zehaztu, tresnak eragiketa guztiak egiten ditu baina fitxategiak idaztea edo ezabatzea galarazten da. Ateratako operazioa segurtasunez ebaluatu daiteke lehendik dauden fitxategiak gainidatzi edo ezabatu gabe.
/allowDelete:{Yes|No|Galdetu} Aukerakoa. Balio lehenetsia Galdetu da. Argudio hau erauzketa batean bakarrik erabiltzen da. /allowDelete:Yes zehazten denean, /folder parametroak zehaztutako karpetan dauden fitxategi guztiak automatikoki ezabatzen dira. /allowDelete:No zehazten denean, ez da ezabatzerik gertatzen. Noiz / allowDelete: Eskaria zehazten da, erabiltzaileari kontsolan bidez galdetzen zaio ezabatzeko eragiketa guztiak baimendu edo ukatzeko. /allowWrite:No zehazten bada, ez da ezabatzerik gertatuko /allowDelete:Yes ere zehaztu bada ere.
/ clobber Aukerakoa. Argudio hau erauzketa batean bakarrik erabiltzen da. / Clobber zehazten denean, irakurtzeko atributu bakarra duten fitxategiak gainidazten edo ezabatzen dira. Ez denean zehazten, fitxategiak irakurtzeko bakarrik atributua gainidatzita edo ezabatuta.
/errorlevel: {Off|Error|Warning|Info|Hitzezkoa} Aukerakoa. Balio lehenetsia Informazioa da. Argudio honek irteerari buruzko informazioa erregistratzeko maila adierazten du.
/map: <fitxategiaren bidea> Aukerakoa. Fitxategien mapak zuzentzen dituen .xml fitxategi baten bidea eta izena. Erauzketa batean erabiltzen denean, / karpeta parametroak zehaztutako karpetaren barruan normalean irakurritako fitxategiak beste mapen fitxategian zehazten den bezala txandakatzen dira. Paketen eragiketan, zuzentarauekin bat datozen fitxategiak ez dira idatzirik.
/nologo Aukerakoa. Ezabatu bandera exekuzioan.
/log: <fitxategiaren bidea> Aukerakoa. Bide-izena eta izena erregistro fitxategi batera. Fitxategia lehendik badago, erregistroari buruzko informazio berria eransten zaio fitxategiari.
@ <fitxategiaren bidea> Aukerakoa. Tresnarako komando lerroko argumentuak dituen fitxategi batera bide eta izena.
/sourceLoc: <katea> Aukerakoa. Argudio honek txantiloi baliabide fitxategia sortzen du eta balio du estraktuetan soilik.

Balio posibleak dira auto edo esportatu nahi duzun hizkuntzarako LCID / ISO kodea. Argumentu hau erabiltzen denean, emandako locale-katearen baliabideak .resx fitxategi neutro gisa ateratzen dira. Bada auto edo etengailuaren forma luzea edo laburra zehazten da, oinarrizko locale edo soluzioa erabiltzen da. Komandoaren forma laburra erabil dezakezu: / src.
/ localize Aukerakoa. Erabili edo batu kate baliabide guztiak .resx fitxategietan. Komandoaren forma laburra erabil dezakezu: /loc. Localize aukerak .resx fitxategientzako partekatutako osagaiak onartzen ditu. Informazio gehiago: RESX web baliabideak erabiltzea

Erabili / map komandoaren argumentua

Hurrengo eztabaidan, / map argumentua SolutionPackager tresnaren erabileraren berri ematen da.

Normalean, eraikitze sistema automatizatu batean eraikitako fitxategiak, esaterako .xap Silverlight fitxategiak eta plug-in multzoak, normalean ez dira iturrien kontrolean kontrolatzen. Baliteke Web-baliabideak iturburu-kontrolean egotea SolutionPackager tresnarekin zuzenean bateragarriak ez diren kokapenetan. / Map parametroa sartuta, SolutionPackager tresna fitxategiak txandakako tokietatik irakurri eta paketatzeko bideratu daiteke, eta ez Erauzketa karpetaren barruan, normalean egiten zen bezala. /map parametroak maparen zuzentarauak dituen XML fitxategi baten izena eta bidea zehaztu behar ditu. Zuzentarau horiek SolutionPackager-i fitxategiak bere izenarekin eta bidearekin bat etortzeko agintzen diote eta bat datorren fitxategia aurkitzeko ordezko kokapena adierazi. Hurrengo informazioa zuzentarau guztiei berdin aplikatzen zaie.

  • Zuzentarau anitz zerrenda daitezke fitxategi berdinekin bat datozen zuzentarauak barne. Fitxategian hasieran zerrendatutako zuzentarauek lehentasuna dute geroago zerrendatutako zuzentarauekiko.

  • Fitxategia edozein zuzentarauekin bat datorrenean, gutxienez, beste kokapen alternatibo batean aurkitu behar da. Bat datorren alternatibarik aurkitzen ez bada, SolutionPackager-ek errore bat emango du.

  • Karpeta eta fitxategi bideak erabatekoak edo erlatiboak izan daitezke. Bide erlatiboak / karpeta parametroak zehaztutako karpetatik ebaluatzen dira beti.

  • Ingurumen aldagaiak %variable% sintaxia erabiliz zehaztu daitezke.

  • Karpeta "**" komodin bat erabil daiteke "edozein azpikarpetetan" esateko. Bide baten azken zati gisa soilik erabil daiteke, adibidez: "c:\folderA\**".

  • Fitxategiaren izenak comodinoak "*.ext" edo inprimakietan bakarrik erabil daitezke "*.*". Ez da beste patroirik onartzen.

    Hiru zuzentarau mapaketa mota deskribatzen dira hemen, nola erabili erakusten duzun adibide batekin batera.

Karpeta esleipena

Ondorengo informazioak karpeta-mapeari buruzko informazio zehatza eskaintzen du.

XML formatua

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

Azalpena

"folderA" bat datozen fitxategi-bideak "folderB"ra aldatzen dira.

  • Bakoitza bakoitzeko azpikarpeten hierarkia bat etorri behar da zehazki.

  • Karpeta komodinak ez dira onartzen.

  • Ezin da fitxategi izenik zehaztu.

    Adibideak

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

Fitxategia Mapak egiteko

Ondorengo informazioak xehetasun gehiago eskaintzen ditu fitxategi-fitxategiko mapeari buruz.

XML formatua

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

Azalpena

map parametroarekin bat datorren edozein fitxategi to parametroan zehaztutako izenetik eta bidetik irakurtzen da.

Honetarako map parametro:

  • Fitxategiaren izena zehaztu behar da. Bidea aukerakoa da. Biderik zehazten ez bada, edozein karpetako fitxategiak bat etorri daitezke.

  • Fitxategi-izen komodinak ez dira onartzen.

  • Karpeta komodina onartzen da.

    Honetarako to parametro:

  • Fitxategiaren izena eta bide-izena zehaztu behar da.

  • Fitxategiaren izena fitxategiaren izenaren araberakoa izan daiteke map parametro.

  • Fitxategi-izen komodinak ez dira onartzen.

  • Karpeta komodina onartzen da.

Adibideak

  <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" />

Goiko NuGet paketearen adibidean, cr886_PluginPackageTest.nupkg ez da gainidazten fitxategia zehaztutako kokapenan badago.

Fitxategia bide-izena esleitzea

Hurrengoak fitxategitik bide-izenera mapari buruzko informazio zehatza eskaintzen du.

XML formatua

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

Azalpena

Fitxategi bat datorren fitxategia map parametroan irakurritako fitxategian zehaztutako izenetik eta bidetik irakurriko da to parametro.

Honetarako map parametro:

  • Fitxategiaren izena zehaztu behar da. Bidea aukerakoa da. Biderik zehazten ez bada, edozein karpetako fitxategiak bat etorri daitezke.

  • Fitxategiaren izena komodina onartzen da.

  • Karpeta komodina onartzen da.

Honetarako to parametro:

  • Bide-izena zehaztu behar da.

  • Karpeta komodina onartzen da.

  • Fitxategiaren izena ez da zehaztu behar.

    Adibideak

  <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" />

Adibidez mapatzea

Hurrengo XML kodearen laginak, SolutionPackager tresnak edozein baliabide irakurtzeko eta sortutako bi muntai lehenetsiak CRMDevTookitSample izenarekin sortutako mapping fitxategi osoa erakusten du.

<?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>

Kudeatutako eta kudeatu gabeko soluzioak

Dataverse konprimitutako konponbidea (.zip) fitxategia bi motetako bat esportatu daiteke hemen erakusten den bezala.

kudeatutako soluzio
Erakunde batean inportatzeko prest dagoen irtenbide osoa. Inportatutakoan, ezin dira osagaiak gehitu edo kendu, nahiz eta aukeran pertsonalizazio gehiago baimendu. Hori gomendagarria da irtenbidea garatzen denean.

Kudeatu gabeko irtenbidea
Gehitu, kendu edo aldatu daitezkeen murrizketarik gabeko irtenbide irekia. Hori gomendagarria da irtenbide bat garatzeko garaian.

Konprimatutako konponbide fitxategiaren formatua desberdina izango da bere motaren arabera, kudeatu edo kudeatu gabe. SolutionPackager-ek konprimitutako konponbide fitxategiak prozesatu ditzake. Hala ere, tresnak ezin du mota bat beste batera bihurtu. Konponbide fitxategiak beste mota batera bihurtzeko modu bakarra, esaterako, kudeatu gabekoetatik kudeatutakoetara, hau da, kudeatu gabeko irtenbidea .zip fitxategia inportatzea da Dataverse zerbitzaria eta gero irtenbidea kudeatutako soluzio gisa esportatu.

SolutionPackager-ek kudeatu gabeko eta kudeatutako soluzio .zip fitxategiak prozesatu ditzake / PackageType: biak parametroaren bidez. Eragiketa hau burutzeko, beharrezkoa da zure irtenbidea mota bakoitzeko bi aldiz esportatzea, .zip fitxategiak honela izendatuz.
.Zip fitxategia kudeatu gabe: AnyName.zip Kudeatutako .zip fitxategia: AnyName_managed.zip

Tresnak kudeatu gabeko fitxategiaren karpeta berean duen kargua berean bere gain hartuko du eta bi fitxategiak karpeta bakarrean aterako ditu kudeatutako eta kudeatu gabeko osagaiak dauden desberdintasunak gordez.

Irtenbide bat kudeatu eta kudeatu gisa atera ondoren, karpeta bakar horretatik posible da biak edo mota bakoitza banan-banan paketatzea, / PackageType parametroa erabiliz zein mota sortu nahi duzun zehazteko. Bi fitxategiak zehaztean, bi .zip fitxategi sortuko dira goian bezala izendatzeko konbentzioa erabiliz. / PackageType parametroa falta bada kudeatu gabeko eta kudeatu gabeko karpeta bikoitz batetik paketatzerakoan, lehenetsi gabeko .zip fitxategi bakarra sortuko da.

Irtenbideak

Erabiltzen baduzu Visual Studio editatzeko baliabide fitxategiak sortuak soluzio paketatzailearen bidez, jasoko duzu mezu bat hurrengoaren antzekoa itzultzerakoan: “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.” Hori gertatzen da Visual Studio ordezkatu egiten dituelako baliabide fitxategiko metadatuen etiketak datuen etiketekin.

Irtenbidea

  1. Ireki baliabide fitxategia zure testu editore gogokoenean eta bilatu eta eguneratu honako etiketa hauek:

    <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. Aldatu nodo izena <data> hurrengora <metadata>.

    Adibidez, kate hau:

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

    Aldaketa hurrengoan:

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

    Horri esker, irtenbide paketatzaileari baliabide fitxategia irakurri eta inportatu ahal izango duzu. Arazoa hau erabiltzean bakarrik ikusi da Visual Studio Baliabideen editorea.

Ikus baita ere

Erabili iturburu-kontrola irtenbide-fitxategiekin
Soluzio kontzeptuak