Az első webextension - mozilla, MDN
Ebben a cikkben, mi megy egészen a létrehozása WebExtension Firefox, az elejétől a végéig. Ez a kiegészítés egyszerűen hozzá egy piros határ az összes oldalt, majd „mozilla.org” vagy annak bármely al-domain.
A kezdéshez meg kell Firefox 45 vagy újabb.
írásban WebExtension
Hozzon létre egy új könyvtárat (mappát), majd kattintson rá:
manifest.json
Most hozzon létre egy új fájlt a „manifest.json” a „borderify” mappát. Helyezze be az alábbi kódot:
- Az első három kulcs: manifest_version. A nevét és verzióját. Ezek kötelező, és tartalmazza az alap metaadatokat a kiegészítést.
- leírás nem kötelező, de ajánlott: ez a leírás jelenik meg a kiegészítőket.
- ikonok nem kötelező, de ajánlott: lehetővé teszi, hogy meghatározza kiegészítéseket az ikonra, hogy látható lesz a kiegészítőket.
- alkalmazások számára kötelező a Firefox. és meghatározza az ID kiegészítések. Azt is fel lehet használni, hogy jelezze a minimális és maximális Firefox, támogatja a bővítés.
A legérdekesebb kulcs van - ez content_scripts. amely azt mondja, hogy a Firefox teher egy script egy weblapon, amelynek URL egyezik a megadott minta. A mi esetünkben, kérünk Firefox letölteni egy script úgynevezett „borderify.js” az összes HTTP vagy HTTPS oldalak kapott „mozilla.org” vagy annak bármely al-domain.
Bizonyos esetekben meg kell adni az azonosító a kiegészítéseket. Ha meg kell adja meg azonosítóját kiegészítések közé tartoznak a legfontosabb alkalmazások manifest.json és a tulajdonságait állítsa gecko.id:
ikonok / border-48.png
Ezenkívül legyen egy ikon (ikon). Ez az ikon jelenik meg a listán a kiegészítői a kiegészítőket. A manifest.json fájl azt mondja, hogy az ikon lesz a fájl „ikonok / border-48.png”.
Hozzon létre egy könyvtárat (mappát) „ikonok” belül „borderify” könyvtárba. Mentse el az ikon néven „border-48.png”. Használhatja az ikont a példa. amely figyelembe egy sor Google Material Design ikonok és annak licence alapján használható Creative Commons Attribution-ShareAlike.
Használhatja egyéni ikont. Méretűnek kell lennie 48x48 pixel. Ön is használja a mérete 96x96 pixel ikon kijelző nagy felbontású monitorokat. Ebben az esetben meg kell adnia azt a tulajdonságát „96” tárgy „ikonok” a manifest.json:
Ön is létrehozhat egy ikon SVG formátumban, és ez lesz helyesen méretezve.
borderify.js
Végül, hozz létre egy könyvtárat „borderify” fájl neve „borderify.js”, és tegye be az alábbi kódot:
Ez a szkript lesz beágyazva egy oldalt, amely megfelel a minta megadott kulcs content_scripts manifest.json fájlt. Ez a szkript közvetlen hozzáférést biztosít a teljes dokumentum, mintha tele volt az oldalon.
Először ellenőrizze, óvatosan, hogy helyesen elhelyezni a fájlokat és megadni nekik a helyes neveket:
Kezdve a megjelenése Firefox 45, akkor átmenetileg állítsa WebExtension egy helyi meghajtóra.
Nyissa meg az oldalt "about: hibakeresés", kattintson a "Load Ideiglenes Add-on", és válassza ki a manifest.json file:
Most a addon telepítése és marad a böngésző, mielőtt újraindul.
Hogy ellenőrizze, menj az oldalra „about: addons”, hogy nyissa meg a kiegészítőket. Meg kell látni a neve mellett, és ikon:
Is, akkor fut WebExtension a parancssorból, a web-ext.
tesztelés
Most megy minden domainoldalnak „mozilla.org”, és el kell látni egy piros szegélyt az oldal körül:
Kísérlet egy kicsit. Változás a szegély színe, vagy mást csinálni az oldal tartalmát. Miután módosította a script mentésre kerül, és az oldal újratöltődik, látni fogja a változást azonnal:
Megjegyezzük, hogy az manifest.json fájl változások, akkor manuálisan kell indítani a kiegészítés. Abban a pillanatban, ez azt jelenti, hogy újra kell indítani a Firefox, majd újra letölteni az amellett, hogy a „about: hibakeresés” oldalon. Azon dolgozunk, hogy javítani ezt a folyamatot.
Csomagolás és kiadás
Hogy mások is használni a kívül meg kell csomagolni. Firefox-kiegészítők, csomagolt formában vannak XPI fájlok, amelyek közösek a ZIP kiterjesztésű fájlok „XPI”.
Ha a csomagolás, vegye figyelembe a következő: a ZIP, azonban csak a fájlokat, amelyek nem tartalmaznak a rendező ( „borderify” nem kap az archívumba). Annak érdekében, hogy a megfelelő XPI fájlt a kiegészítőket, menjen a könyvtárba „borderify” a parancssort, és futtassa a következő parancsot:
zip -r. /borderify.xpi *
Kezdve Firefox 43, az összes módosítással alá kell írnia, mielőtt azok lesznek telepítve a böngészőben. Akkor távolítsa el ezt a korlátozást csak a Firefox fejlesztői kiadás, illetve a Firefox Nightly a következő lépéseket:
- menj az oldalra about: config Firefoxban
- használja a kereső szöveg talált xpinstall.signatures.required
- duplán kattintva az ingatlan vagy használja a helyi menüt (kattintson a jobb egérgombbal), válassza ki a „Toggle”, hogy állítsa az értéket false.
Mi a következő lépés?
Most, hogy van egy ötlete a fejlesztési Firefox kiegészítőket, akkor: