Notă
Accesul la această pagină necesită autorizare. Puteți încerca să vă conectați sau să modificați directoarele.
Accesul la această pagină necesită autorizare. Puteți încerca să modificați directoarele.
SolutionPackager este un instrument care poate descompune reversibil un fișier de soluție comprimat Microsoft Dataverse în mai multe fișiere XML și alte fișiere. Apoi puteți gestiona cu ușurință aceste fișiere utilizând un sistem de control al sursei. Următoarele secțiuni vă arată cum să rulați instrumentul și cum să utilizați instrumentul cu soluții gestionate și negestionate.
Important
Instrumentul SolutionPackager nu mai este metoda recomandată pentru despachetarea și împachetarea soluțiilor. Capabilitățile instrumentului SolutionPackager sunt integrate în CLI Power Platform. Comanda pac solution are multe verbe, inclusiv unpack, pack, clone, și sync care încorporează aceleași capabilități de bază ca instrumentul SolutionPackager.
Unde să găsiți instrumentul SolutionPackager
Instrumentul SolutionPackager este distribuit ca parte a Microsoft. Pachetul NuGet CrmSdk.CoreTools NuGet. Pentru a instala programul, urmați acești pași.
- Descărcați pachetul NuGet .
- Redenumiți extensia numelui de fișier al pachetului din .nupkg în .zip.
- Extrageți conținutul fișierului comprimat (zip).
Găsiți executabilul SolutionPackager.exe în folderul <nume-folder-extras>/contents/bin/coretools. Rulați programul din folderul coretools sau adăugați folderul respectiv la PATH.
Argumente din linia de comandă SolutionPackager
SolutionPackager este un instrument în linie de comandă. O puteți invoca utilizând parametrii descrisi în tabelul următor.
| Argument | Descriere |
|---|---|
| /action: {Extract|Pachet} | Necesar Acțiunea de efectuat. Acțiunea poate fi fie extragerea unui fișier .zip de soluție într-un folder, fie ambalarea unui folder într-un fișier .zip. |
| /zipfile: <cale fișier> | Necesar Calea și numele unui fișier .zip al soluției. La extragere, fișierul trebuie să existe și să fie lizibil. La arhivare, fișierul este înlocuit. |
| /folder: <cale folder> | Necesar Calea către un folder. La extragere, acest folder este creat și completat cu fișiere componente. La arhivare, acest folder trebuie să existe deja și să conțină fișiere de componente extrase anterior. |
| /packagetype: {Unmanaged|Managed|Ambele} | Opțional. Tipul de pachet de procesat. Valoarea implicită este Negestionat. Omiteți acest argument în majoritatea cazurilor, deoarece instrumentul poate citi tipul de pachet din interiorul .zip fișiere sau fișiere componente. La dezarhivare și când este specificat Ambele, fișierele .zip ale soluției gestionate și negestionate trebuie să fie prezente și sunt procesate într-un singur folder. Când se împachetează și se specifică Ambele, fișierele .zip ale soluțiilor gestionate și negestionate sunt generate dintr-un singur folder. Pentru mai multe informații, consultați secțiunea despre lucrul cu soluții gestionate și negestionate mai târziu în acest articol. |
| /allowWrite:{Yes|No} | Opțional. Valoarea implicită este Da. Utilizați acest argument numai în timpul unei extrageri. Atunci când specificați /allowWrite:Nu, instrumentul efectuează toate operațiunile, dar nu scrie sau șterge niciun fișier. Puteți evalua în siguranță operațiunea de extragere fără a suprascrie sau a șterge fișiere existente. |
| /allowDelete:{Yes|No|Mesaj} | Opțional. Valoarea implicită este Atenționare. Utilizați acest argument numai în timpul unei extrageri. Atunci când specificați /allowDelete:Yes, instrumentul șterge automat toate fișierele prezente în folderul specificat de parametrul /folder care nu sunt așteptate. Atunci când specificați /allowDelete:No, instrumentul nu șterge niciun fișier. Atunci când specificați /allowDelete:Prompt, utilizatorului i se solicită prin consolă să permită sau să refuze toate operațiunile de ștergere. Dacă specificați /allowWrite:Nu, instrumentul nu șterge niciun fișier, chiar dacă este specificat /allowDelete:Yes. |
| /clobber | Opțional. Utilizați acest argument numai în timpul unei extrageri. Atunci când specificați /clobber, instrumentul suprascrie sau șterge fișierele care au setat atributul doar în citire. Atunci când nu este specificat, instrumentul nu suprascrie sau șterge fișiere cu atributul doar în citire. |
| /errorlevel: {Dezactivat|Eroare|Avertisment|Informații|Verbose} | Opțional. Valoarea implicită este Info. Acest argument indică nivelul de înregistrare a informațiilor la ieșire. |
| /map: <cale fișier> | Opțional. Calea și numele unui fișier .xml care conține directive de mapare a fișierelor. Atunci când este utilizat în timpul unei extrageri, instrumentul citește fișierele citite de obicei din interiorul folderului specificat de parametrul /folder din locații alternative, după cum este specificat în fișierul de mapare. În timpul unei operațiuni de ambalare, instrumentul nu scrie fișiere care corespund directivelor. |
| /nologo | Opțional. Suprimați banner-ul la timpul de execuție. |
| /log: <cale fișier> | Opțional. O cale și un nume către un fișier jurnal. Dacă fișierul există deja, noi fișiere de înregistrare sunt adăugate la fișier. |
| @ <cale fișier> | Opțional. O cale și un nume către un fișier care conține argumente din linia de comandă pentru instrument. |
| /sourceLoc: <șir> | Opțional. Acest argument generează un fișier de resurse șablon și este valabil doar la dezarhivare. Valorile posibile sunt auto sau un cod LCID/ISO pentru limba pe care doriți să o exportați. Atunci când utilizați acest argument, instrumentul extrage resursele de șir din setările regionale date ca fișier .resx neutru. Dacă specificați auto sau doar forma lungă sau scurtă a argumentului, se utilizează setările regionale de bază sau soluția. Puteți utiliza forma scurtă a comenzii: /src. |
| /localizare | Opțional. Extrageți sau îmbinați toate resursele șir în fișiere .resx. Puteți utiliza forma scurtă a comenzii: /loc. Opțiunea de localizare acceptă componente partajate pentru fișierele .resx. Pentru mai multe informații, consultați Utilizarea resurselor web RESX. |
| /NumeSoluție: <nume> | Opțional. Numele unic al soluției de împachetat sau extras atunci când folderul sursă conține mai multe soluții sub solutions/*/solution.yml. Este necesar atunci când se detectează mai multe soluții. Se aplică doar formatului de control versiune YAML. Poți folosi forma scurtă a comenzii: /sn. |
| /remapPluginTypeNames | Opțional. Când este specificat, instrumentul remapează numele de tipuri complet calificate pe baza ansamblurilor incluse în soluție. Activat implicit în formatul de control versiune YAML. Poți folosi forma scurtă a comenzii: /fp. |
Formate de fișiere pentru controlul sursei
SolutionPackager suportă două aranjamente de foldere la extragerea și ambalarea soluțiilor.
Format XML (moștenire)
Formatul original. Instrumentul stochează metadatele soluției în Other\Solution.xml și Other\Customizations.xml. Instrumentul extrage toate fișierele componente într-o ierarhie de foldere plate împreună cu acele fișiere. Acest format este formatul implicit atunci când extrageți un .zip fișier fără mai multe configurații.
Format de control versiune YAML
Introdus împreună cu integrarea Dataverse Git, acest format stochează metadatele soluției ca fișiere YAML distribuite într-o ierarhie structurată a folderelor. Este formatul scris atunci când comiteți soluții utilizând integrarea nativă Git în Power Apps.
Avantaje față de formatul XML
- Produce diffs mai curat, mai ușor de citit per componentă în controlul sursei.
- Acceptă mai multe soluții într-un singur folder de depozit.
- Fișierele aplicației
.msappPânză și fluxurile moderne sunt acceptate doar în acest format. - Remaparea numelui tipului insertului este activată în mod implicit.
Structura necesară a dosarelor
<rootFolder>/
├── solutions/
│ └── <SolutionUniqueName>/
│ ├── solution.yml (solution metadata)
│ ├── solutioncomponents.yml (paths to all component files)
│ ├── rootcomponents.yml (root-level components)
│ └── missingdependencies.yml (dependency info)
├── publishers/
│ └── <PublisherUniqueName>/
│ └── publisher.yml (publisher definition)
├── entities/ (entity components, if present)
├── workflows/ (classic workflows, if present)
├── modernflows/ (Power Automate cloud flows, if present)
├── canvasapps/ (canvas app .msapp files, if present)
└── [other component folders]/
Important
Prezența unui solutions/ subfolder care conține *solution.yml fișiere indică formatul YAML.
Dacă plasați fișierele manifest YAML (solution.yml, solutioncomponents.ymlși așa mai departe) în rădăcina folderului, nu sub solutions/<SolutionUniqueName>/, instrumentul nu detectează formatul YAML. Instrumentul revine la calea XML și raportează o eroare înșelătoare privind lipsa unui Customizations.xmlfișier . Vezi secțiunea Depanare pentru informații despre cum să rezolvi această problemă.
Mai multe informații: Referință la formatul de control versiune YAML al soluției
Reguli de auto-detectare a formatului
| Condiție | Formatul folosit |
|---|---|
solutions/*/solution.yml Găsit — exact o soluție |
formatul YAML, unde numele soluției este dedus din folder |
solutions/*/solution.yml găsit — soluții multiple |
formatul YAML, unde /SolutionName argumentul este necesar |
Nu există solutions/ subdirector prezent |
Format XML (moștenire) |
Împachetarea unui folder în format YAML
Următoarea comandă împachetează un folder în format YAML.
SolutionPackager.exe /action:Pack /zipfile:MySolution.zip /folder:C:\repos\myrepo
Împachetarea dintr-un folder multi-soluție
Următoarea comandă împachetează o soluție specificată într-un folder multi-soluție.
SolutionPackager.exe /action:Pack /zipfile:SolutionA.zip /folder:C:\repos\myrepo /SolutionName:SolutionA
Folosiți argumentul comenzii /map
Următoarea discuție detaliază utilizarea argumentului /map la instrumentul SolutionPackager.
Fișierele încorporate într-un sistem automatizat de compilare, cum .xap ar fi fișierele Silverlight și asamblările de pluginuri, nu sunt de obicei arhivate în controlul sursei. Este posibil să aveți deja resurse web în controlul sursei în locații care nu sunt compatibile direct cu instrumentul SolutionPackager. Prin includerea parametrului /map, puteți direcționa instrumentul SolutionPackager pentru a citi și a împacheta astfel de fișiere din locații alternative, nu din interiorul folderului Extragere. Parametrul /map trebuie să specifice numele și calea către un fișier XML care conține directive de mapare. Aceste directive instruiesc SolutionPackager să potrivească fișierele după numele și calea lor și să indice locația alternativă pentru a găsi fișierul potrivit. Informațiile următoare se aplică tuturor directivelor în mod egal.
Puteți lista mai multe directive, inclusiv acele directive care corespund fișierelor identice. Directivele listate la începutul fișierului au prioritate față de directivele listate ulterior.
Dacă un fișier se potrivește cu orice directivă, acesta trebuie să fie găsit în cel puțin o locație alternativă. Dacă nu se găsesc alternative potrivite, SolutionPackager emite o eroare.
Căile folderului și fișierelor pot fi absolute sau relative. Căile relative sunt întotdeauna evaluate din folderul specificat de parametrul /folder.
Specificați variabilele de mediu utilizând o
%variable%sintaxă.Utilizați un metacaracter
**de folder pentru a însemna "în orice subfolder". Îl puteți utiliza doar ca parte finală a unei căi, de exemplu:c:\folderA\**.Utilizați caractere wildcard cu numele de fișier doar în formulare
*.extsau*.*. Nu este acceptat niciun alt model.Următoarea secțiune descrie cele trei tipuri de mapări de directive, împreună cu un exemplu care vă arată cum să le utilizați.
Mapare de folder
Următoarea secțiune furnizează informații detaliate despre maparea folderelor.
XML Format
<Folder map="folderA" to="folderB" />
Descriere
Căile de fișier care se potrivesc cu "folderA" comută la "folderB".
Ierarhia subfolderelor de sub fiecare folder trebuie să corespundă exact.
Caracterele wildcard pentru foldere nu sunt acceptate.
Nu puteți specifica numele fișierelor.
Exemple
<Folder map="folderA" to="folderB" /> <Folder map="folderA\folderB" to="..\..\folderC\" /> <Folder map="WebResources\subFolder" to="%base%\WebResources" />
Mapare fișier-la-fișier
Următoarele informații oferă mai multe detalii despre maparea fișier-la-fișier.
XML Format
<FileToFile map="path\filename.ext" to="path\filename.ext" />
Descriere
Orice fișier care se map potrivește cu parametrul citește din numele și calea specificată to în parametru.
Pentru parametrul map:
Specificați un nume de fișier. Calea este opțională. Dacă nu specificați o cale, maparea poate potrivi fișierele din orice folder.
Caracterele wildcard pentru numele de fișier nu sunt acceptate.
Acceptă metacaracterul folderului.
Pentru parametrul
to:Specificați un nume de fișier și o cale.
Numele de fișier poate fi diferit de numele parametrului
map.Caracterele wildcard pentru numele de fișier nu sunt acceptate.
Acceptă metacaracterul folderului.
Exemple
<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" />
În exemplul precedent de pachet NuGet, cr886_PluginPackageTest.nupkg nu este suprascris dacă fișierul există deja în locația specificată.
Mapare fișier-la-cale
Următoarea secțiune oferă informații detaliate despre maparea fișier-la-cale.
XML Format
<FileToPath map="path\filename.ext" to="path" />
Descriere
Parametrul map specifică fișierul de potrivit, iar to parametrul specifică calea de citit de la.
Pentru parametrul map:
Specificați un nume de fișier. Calea este opțională. Dacă nu specificați o cale, maparea poate potrivi fișierele din orice folder.
Acceptă metacaractere nume de fișier.
Acceptă metacaracterul folderului.
Pentru parametrul to:
Specificați o cale.
Acceptă metacaracterul folderului.
Nu specificați un nume de fișier.
Exemple
<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" />
Exemplu de mapare
Următorul exemplu de cod XML arată un fișier de mapare complet care permite instrumentului SolutionPackager să citească orice resursă web și cele două ansambluri generate implicit dintr-un proiect de instrument pentru dezvoltatori numit 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>
Soluții gestionate și negestionate
Puteți exporta un fișier Dataverse comprimat (.zip) ca soluție gestionată sau negestionată.
Soluție gestionată
O soluție finalizată gata de importat într-o organizație. Odată importat, nu puteți adăuga sau elimina componente, deși, opțional, puteți permite particularizări suplimentare. Utilizați acest tip atunci când se termină dezvoltarea soluției.
Soluție negestionată
O soluție deschisă fără restricții cu privire la ceea ce puteți să adăugați, să eliminați sau să modificați. Utilizați acest tip în timpul dezvoltării unei soluții.
Formatul unui fișier soluție comprimat diferă în funcție de tipul său, gestionat sau negestionat. SolutionPackager poate prelucra fișiere cu soluție comprimată de orice tip. Totuși, unealta nu poate converti un tip în altul. Singura modalitate de a efectua conversia fișierelor soluție la un alt tip, cum ar fi de la negestionat la gestionat, este importul soluției negestionate .zip fișier într-un server Dataverse, apoi exportul soluției ca soluție gestionată.
SolutionPackager poate procesa soluții negestionate și gestionate .zip fișiere ca un set combinat, utilizând /PackageType:Both parametrul. Pentru a efectua această operațiune, trebuie să exportați soluția de două ori pe măsură ce fiecare tip. Denumiți fișierele .zip după cum urmează:
Fișier .zip negestionat: AnyName.zip
Fișier .zip gestionat: AnyName_managed.zip
Instrumentul presupune că fișierul zip gestionat se află în același folder ca fișierul negestionat. Aceasta extrage ambele fișiere într-un singur folder și păstrează diferențele în care există componente gestionate și negestionate.
După ce extrageți o soluție atât ca negestionată, cât și gestionată, puteți să împachetați ambele tipuri sau fiecare tip individual din acel singur folder. Utilizați parametrul pentru a specifica /PackageType ce tip să creați. Atunci când specificați ambele fișiere, instrumentul produce două fișiere .zip utilizând convenția de denumire anterioară. Dacă nu includeți /PackageType parametrul atunci când împachetați dintr-un folder dual gestionat și negestionat, setarea implicită este să produceți un singur fișier .zip negestionat.
Depanarea
Mesaj afișat când se folosește Visual Studio pentru a edita fișiere de resurse
Dacă utilizați Visual Studio pentru a edita fișierele de resurse create de pachetul de soluții, este posibil să vedeți un mesaj atunci când respachetați similar cu acesta: "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." Acest mesaj apare deoarece Visual Studio înlocuiește etichetele de metadate ale fișierului de resurse cu etichete de date.
Soluție
Deschideți fișierul de resurse în editorul de text preferat, apoi găsiți și actualizați următoarele etichete:
<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">Schimbați numele nodului din
<data>în<metadata>.De exemplu, acest șir:
<data name="Source LCID" xml:space="preserve"> <value>1033</value> </data>Se modifică în:
<metadata name="Source LCID" xml:space="preserve"> <value>1033</value> </metadata>Această modificare permite pachetului de soluții să citească și să importe fișierul de resurse. Această problemă apare doar atunci când utilizați editorul de resurse Visual Studio.
Eroare: "Nu se găsește fișierul necesar ...\Other\Customizations.xml" cu un folder YAML
Această eroare apare atunci când rulați SolutionPackager (sau pac solution pack) într-un folder care conține fișiere YAML, cum solution.ymlar fi , dar plasați acele fișiere în rădăcina folderului, nu în interiorul subfolderului necesar solutions/<SolutionUniqueName>/ .
Cauza: Instrumentul detectează formatul de control versiune YAML căutând un solutions/ subfolder care conține *solution.yml fișiere. Când acel director lipsește, unealta revine silențios la formatul XML (legacy) și se așteaptă Other\Customizations.xmlla . Mesajul de eroare se referă la un fișier XML și nu menționează YAML, ceea ce poate fi derutant.
Corectare: Reorganizează folderul astfel încât fișierele manifest YAML să fie pe căile corecte:
<rootFolder>/
solutions/<YourSolutionUniqueName>/ ← move solution.yml here
solution.yml
solutioncomponents.yml
rootcomponents.yml
missingdependencies.yml
publishers/<YourPublisherUniqueName>/
publisher.yml
Dacă ați obținut folderul de la o comitere a integrării Git sau pac solution clone, structura de foldere este deja corectă. Un folder care conține doar fișierele YAML de nivel superior fără solutions/ subdirector reprezintă o extragere incompletă și nu poate fi ambalat direct.
Atenție: componenta declarată în rootcomponents.yml nu are fișiere sursă
Acest avertisment apare atunci când un component, cum ar fi o aplicație canvas, este listat în, rootcomponents.yml dar nu există fișiere sursă corespunzătoare în folderul component așteptat (de exemplu, canvasapps/<schema-name>/).
Efect: Instrumentul reușește totuși (cod de ieșire 0) și produce un fișier valid .zip , dar componenta declarată este omisă din soluția ambalată.
Cauza: Folderul era produs printr-o extragere parțială sau fișierele sursă ale componentei nu erau incluse în depozit. De exemplu, doar fișierele manifest ale soluției au fost confirmate, nu și aplicația canvas în sine.
Corectare: Asigurați-vă că toate componentele declarate în rootcomponents.yml au fișierele sursă corespunzătoare prezente în folder. Pentru aplicațiile Canvas, fișierul .msapp trebuie să existe sub canvasapps/<schema-name>/. Dacă lipsește vreun fișier, reexportă soluția completă din Dataverse și despachetează-o din nou, sau folosește-o pac solution clone pentru a obține o extragere completă.