MANIFEST fișierele (manifest) - tutorial xul, MDN

În acest capitol, vom descrie modul de a colecta fișierele Xul chrome și în pachete și modul de a crea pachete pentru aceste fișiere manifest.

Pachetul - un set de fișiere Xul și script-uri care definesc funcționalitatea interfeței cu utilizatorul. Pachetele pot fi instalate în Mozilla și pot fi referite folosind un crom URL-uri. Pachetul poate include orice tipuri de fișiere și pot fi distribuite pe subdirectoare pentru diferite părți ale pachetului. Pe ambalajul discului poate fi stocat fie în despachetat din dosarul său, sau sub forma unui fișier JAR.

Manifestul

MANIFEST fișierele descrie pachetul și va afișa locația de pe disc la URL-ul de crom. MANIFEST fișierele situate în dosarul crom ( / Chrome) Mozilla citit atunci când aplicația începe să se determine ce sunt instalate pachete. Acest lucru înseamnă că tot ce trebuie să faceți pentru a instala un nou pachet este adăuga un nou fișier manifest în dosarul crom, sau o aplicație sau un dosar anumit utilizator crom. Cea de a doua dintre opțiunile de mai sus pot fi utilizate în cazul în care nu aveți drepturi suficiente pentru a scrie în dosarul aplicației.

Dacă doriți doar să încercați testarea unui cod XUL privilegiat în browser-ul Firefox, puteți face cu ușurință acest lucru folosind manifest, format din doar o singură linie:

1. Creați un folder nou undeva pe disc. De exemplu, pe un computer care rulează Windows, puteți crea un folder "C: \ testfiles".
2. Crearea unui nou ASCII 1 fișier numit test.manifest în dosarul crom. Numele fișierului nu contează, principalul lucru care a fost o .manifest prelungire. (1 nu funcționează cu UTF-8 cu BOM).
3. Scrieți fișierul pentru a crea un șir de caractere:

Asta-i tot! Acum, tot ce trebuie să faceți este să adăugați câteva fișiere Xul în dosarul nou, și le puteți descărca prin tastarea URL-ul Chrome de forma „crom: //tests/content/tests.xul “. Desigur, trebuie să reporniți browser-ul pentru ca modificările să aibă efect. Dacă fișierul nu se încarcă, asigurați-vă că ați introdus calea către directorul.

Liniile de bază ale sintaxei fișier manifest pentru pachetele de conținut este după cum urmează:

„conţinut '

Primul câmp „conținut“ indică un pachet de conținut. Pentru aceasta va fi „pielea“, și „limba“ - în conformitate cu setările locale. Numele pachetului în exemplul de mai sus - „teste“, ceea ce înseamnă că primul câmp din URL-ul de crom - aceasta este „teste“, cum ar fi crom: //tests/content/sample.xul. Dacă numele pachetului a fost „browser-ul“, crom URL-ul ar arata crom: //browser/content/browser.xul. Ultimul câmp - este calea către directorul care conține fișierele. Acest lucru poate fi o cale către un director de pe discul local specificat ca adresa URL a fișierului și fișierul JAR la URL-ul specificat folosind borcanul, pe care vom descrie mai jos. Puteți descrie câteva pachete pentru a include mai multe linii în fișierul manifest.

browser.manifest fișier care este folosit în Firefox, arată astfel:

Enumerate aici sunt două pachete, „branding“ și „browser-ul“. De asemenea, sunt afișate trei suprapunere care vă permite să combinați împreună conținut din diferite pachete. Extensiile suprapunerile folosite la fel de des ca extensii integrează interfața în interfața browser-ului.

Căile de fișier pachete „branding“ și „browser-ul“ utilizați URL-ul JAR, deoarece conținutul este ambalat într-o arhivă. Fișierul JAR poate fi creat folosind un ZIP utilitar. Pentru un fișier JAR localizat în directorul de crom, sintaxa este destul de simplu:

Pentru „browser-ul“ pachet de arhivă - browser.jar, situat în apropiere de fișierul manifest, în directorul crom. Calea „conținut / browser-ul“ specifică calea din interiorul arhivei în cazul în care se află fișierele Xul. Nu aveți nevoie să specificați calea, dacă nu aveți nici o directoare în arhivă. În acest caz, fișierele pachet „branding“ este stocat pe o cale diferită în aceeași arhivă.

Pentru pachetul „teste“, creat mai sus, fișierele nu sunt ambalate în arhivă, în schimb un mod direct de a accesa fișiere. Este bine pentru dezvoltare, astfel încât nu trebuie să pachet toate fișierele de fiecare dată când le modificați. Cu toate acestea, atunci când se distribuie o aplicație sau o extensie, ați putea dori să le împacheteze în arhiva pentru a evita să instalați o mulțime de fișiere individuale mici.

Temele și locales

Pentru aceste locații și sintaxa este similară cu cea utilizată pentru pachetele de conținut, dar ar trebui să specificați întotdeauna pachetul de conținut pentru care furnizează o temă sau locale. De exemplu:

Pentru acest lucru a fost adăugat un nou câmp care indică faptul că tema și locale utilizate pentru browser. Numele pielii - „clasic / 1.0“. În acest caz, numărul versiunii face parte din titlul subiectului, dar este necesar dacă doriți să creați propria temă. Mozilla nu se ocupă numărul versiunii în orice mod special; numărul versiunii - este doar o parte din titlul subiectului. Locale - 'en-US'. Chrome URL-uri sunt afișate pe aceste elemente vor arata astfel: crom: //browser/skin/browser.css și crom: //browser/locale/browser.dtd. Dacă vă creați propria temă sau locale pentru browser-ul, tot ceea ce ai nevoie - pentru a crea un fișier manifest cu unul dintre aceste două linii în ea, modificat, astfel încât să se potrivească în temă sau codul local.

Pentru mai multe informații despre teme, consultați. Topics aici. Pentru mai multe informații despre locații, vezi. Localizare aici.

Exemplul nostru găsi fișiere de dialog

Să creeze un fișier manifest pentru dialogul File Search, pe care o vom analiza, ca exemplu în acest manual. Puteți combina toate cele trei tipuri într-un singur fișier, dacă doriți. Acest lucru se poate realiza prin crearea unei extensii în așa fel încât toate părțile vor fi în același fișier. Vom face acest lucru pentru căutarea de dialog fișiere. Creați fișier findfile.manifest în dosarul crom. Introduceți următoarele linii:

Creați dosare noi enumerate mai sus. Nu contează în cazul în care se va crea aceste dosare, dar căile de fișier din manifest trebuie să indice aceste dosare. Cel mai probabil veți utiliza aceste căi pentru dosare, care este convenabil de a utiliza în sistemul de operare. Dacă repartizăm pachet, am pachet toate fișierele într-un fișier JAR, și să modifice ruta. În acest caz, am demonstrat doar fișierul manifest și să se pregătească un dosar, de exemplu, care vor fi descrise în capitolele următoare.

Notă modul în care al doilea câmp de linii pentru piele și local specifică „findfile“. Acest lucru înseamnă că pielea și locale a schimbat findfile pachet care a fost listat în primul rând. Trei moduri subdirectoare indicate mai sus pentru fiecare parte. Este posibil să doriți să creați aceste subdirectoare pentru a păstra toate fișierele în mod individual.

Instalarea pachetului

Firefox manager de extensii instalează extensiile ambalate în fișiere XPI automat. Se recomandă să încărcați extensii la Mozilla programele de completare. în cazul în care utilizatorii pot găsi pentru a instala. Desigur, puteți instala extensii de pe orice site-uri, dar alte site-uri nu sunt configurate pentru a permite setarea implicită.

În ceea ce privește aplicațiile de sine stătătoare, ele pot fi ambalate cu ajutorul unor programe xulrunner. Acest lucru va crea un singur fișier executabil și aplicația poate fi setată independent de browser.

Pentru mai multe informații despre crearea de extensii, a se vedea. Extensii. Pentru mai multe informații despre XulRunner, capitolul xulrunner.

Dacă creați aplicații pentru versiunile mai vechi ale software-ului Mozilla, care este, înainte de a Firefox 1.5 sau Mozilla 1.8, procesul este puțin mai complicat. Iată cum puteți să creați un pachet pentru versiunile mai vechi. Această secțiune poate fi omisă în cazul în care creați numai noi extensii sau aplicații XUL.

Notă. Acest proces învechit, dar cu toate acestea, este de asemenea utilizat pentru noul produs SeaMonkey 1.0. Nucleul acestui proiect, codul încă nu funcționează cu noul format de „Manifest“.

Dacă creați o parte a pielii și / sau locale, repetați pașii de mai sus, cu diferența că formatul „contents.rdf“ fișierul va fi oarecum diferit. Poti sa te uiti la fișierele „contents.rdf“ alte aplicații, pentru detalii suplimentare.

Rezolvarea problemelor

Crearea unui pachet de crom poate fi de multe ori destul de complex și dificil de a identifica problemele care apar. Iată câteva sfaturi cu privire la caz, dacă aveți ceva să vină la un impas.

Pentru mai multe informații despre fișierele manifest, consultați. Chrome de înregistrare.

În capitolul următor vom proceda la o descriere mai detaliată a limbii XUL.

Vă mulțumim! Vă rugăm să verificați dosarul dvs. „Inbox“ pentru a confirma abonamentul.

Dacă anterior nu a confirmat abonarea la newsletter Mozilla, va trebui să o facă. Vă rugăm să verificați inbox-ul sau spam în căsuța poștală pentru a vedea dacă acesta nu a fost o scrisoare de la noi.

Ascunde abona la newsletter

De ce MDN arată diferit?

MDN se schimbă, concentrându-se doar pe documentația tehnologiilor web. Toate același conținut mare de a rămâne aici; vom schimba doar elementele vizuale și de navigare pentru a vă ajuta să găsiți rapid documentația pentru tehnologia web.

Dar nu vă faceți griji, MDN și Mozilla sunt încă împreună. De fapt, vom actualiza numai proiectarea MDN în mod repetat, pentru a se conforma cu noua emblema și culorile Mozilla.

Cititi mai multe despre reproiectarea în post pe blog-ul nostru. Vă mulțumim pentru utilizarea MDN!

Ascunde mesaj despre reproiectarea