Instrumentul pentru crearea și editarea unui manifest ()

Instrumentul de creare și editare manifest (Mage.exe) este un instrument de linie de comandă care acceptă crearea și editarea manifestărilor de aplicații și de implementare. Ca instrument de linie de comandă, Mage.exe poate fi rulat atât în ​​scripturi batch, cât și în alte aplicații Windows, inclusiv aplicații ASP.NET.







În loc de Mage.exe, puteți utiliza, de asemenea, MageUI.exe, o aplicație grafică. Pentru mai multe informații, consultați Instrumentul de creare și editare manifest, Client grafic (MageUI.exe).

Mage.exe și MageUI.exe sunt disponibile în diverse locații, inclusiv următoarele:

Următorul tabel prezintă comenzile acceptate de Mage.exe. Pentru mai multe informații despre opțiunile acceptate de aceste comenzi, consultați opțiunile de comandă New și Update și opțiunile de comandă Sign.

Șterge memoria cache a aplicațiilor descărcate pentru toate aplicațiile care interacționează online prin rețea.

-n, -New type of file [new_parameters]

Creează un fișier nou cu tipul specificat. Tipurile valide sunt:

Implementare. Creează un nou manifest de implementare.

Aplicație. Creează un nou manifest de aplicații.

Dacă nu sunt specificați parametri suplimentari cu această comandă, acesta va crea un fișier de tip corespunzător, cu etichetele și valorile implicite corespunzătoare.

Pentru a specifica numele și calea fișierului pentru noul fișier, utilizați parametrul -ToFile (consultați tabelul următor).

Pentru a crea un manifest de aplicații cu toate ansamblurile de aplicații adăugate la secțiune manifest, este utilizat parametrul -FromDirectory (consultați tabelul următor).

-u, -Update [calea_pachetului] [update_parameters]

Efectuați una sau mai multe modificări în fișierul manifest. Nu este necesar să specificați tipul fișierului editat. Programul Mage.exe va testa fișierul utilizând un set de euristici și va determina dacă este vorba despre o manifestare de implementare sau despre un manifest de aplicații.

Dacă dezvoltatorul a semnat deja fișierul utilizând un certificat, parametrul -Update va elimina caseta de semnătură a semnăturii. Acest lucru se datorează faptului că semnătura cheii conține un fișier hash, iar schimbarea fișierului face invalidarea hash-ului.







Pentru a specifica numele și calea unui fișier nou în locul suprascrierii unui fișier existent, utilizați parametrul -ToFile (consultați tabelul următor).

Acesta este un nou parametru în .NET Framework 3.5.

Acest steguleț este utilizat numai dacă aplicația este o aplicație Windows Presentation Foundation (WPF) găzduită în Internet Explorer, nu un fișier executabil autonom. Valorile valide sunt "true" sau "t" și "false" sau "f".

Pentru manifestările de aplicații, inserează atributul hostInBrowser sub elementul entrypoint al manifestului de aplicații.

Pentru manifestarea implementării, setează atributul de instalare al elementului de implementare la fals și salvează manifestul de implementare utilizând extensia XBAP. Setarea acestui argument împreună cu argumentul -Install duce la o eroare, deoarece aplicația plasată în browser nu poate fi o aplicație instalabilă, independentă.

Semnați opțiunile de comandă

Următorul tabel conține opțiunile acceptate de comanda -Sign. aplicată tuturor tipurilor de fișiere.

Specifică locația certificatului digital pentru semnarea manifestului. Acest parametru poate fi utilizat împreună cu parametrul -Password.

-ch, -CertHash hashSignature

Valoarea hash a certificatului digital stocat în magazinul de certificate personal al computerului client. Aceasta corespunde proprietății Thumbprint a certificatului digital afișat în Consola de certificate Windows.

Parametrul HashSignature poate fi setat sau în caz de sus sau de jos, și pot fi furnizate fie ca un rând întreg, sau sub forma de octeti proprietăți Amprentă, separate prin spații, și toate proprietățile Amprentă, în ghilimele.

Parola utilizată pentru a semna manifestul cu certificatul digital. Trebuie utilizat împreună cu parametrul -CertFile.

Semnarea este ultima sarcină pe care un dezvoltator trebuie să o îndeplinească, deoarece un document semnat utilizează o valoare hash a fișierului pentru a verifica semnătura documentului. Când faceți orice modificări în fișier, dezvoltatorul trebuie să semneze din nou acest fișier. Dacă semnați un document care a fost deja semnat, programul Mage.exe îl înlocuiește pe cel vechi cu unul nou.

Atunci când se utilizează opțiunea de a umple de implementare -AppManifest manifestă programul Mage.exe presupune că cererea manifestă va fi în același director ca și desfășurarea manifestă într-un subdirector al cărui nume se potrivește cu versiunea curentă de desfășurare, și ajustează desfășurarea manifestă. Dacă cererea manifest va locui în altă parte, pentru instalarea unei locații alternative, puteți utiliza parametrul -AppCodeBase.

Înainte de implementarea unei aplicații, manifestul de implementare și manifestul de aplicație trebuie să fie semnate. Pentru un ghid pentru semnarea documentelor, consultați Înțelegerea implementării aplicațiilor de încredere.

Următorul exemplu deschide o interfață de utilizator pentru Mage (MageUI.Exe).

Următoarele exemple creează manifestul implicit de implementare și manifestul aplicației. Aceste fișiere sunt create în directorul de lucru curent și numit deploy.application și application.exe.manifest, respectiv.







Articole similare

Trimiteți-le prietenilor: