В тази статия, ние ще отидем по целия път до създаването на WebExtension Firefox, от началото до края. Това допълнение просто ще добави червена рамка за всички страници, натоварени с "mozilla.org" или някой от неговите поддомейни.
За да започнете, трябва Firefox 45 или по-късно.
писането WebExtension
Създаване на нова директория (папка), а след това щракнете върху:
manifest.json
Сега се създаде нов файл, наречен "manifest.json" в папка "borderify". Поставете следния код:
- Първите три клавиши: manifest_version. името и версията. Те са задължителни и да съдържа основния метаданни за добавката.
- описание не е задължително, но се препоръчва: това описание се показва в диспечера на добавки.
- иконите не са задължителни, но е препоръчително да се: позволява ви да определите допълнения към иконата, която ще се вижда в управлението на добавките на.
- приложения е задължително за Firefox. и определя допълнения ID. Тя може да се използва за обозначаване на минимален и максимален версия на Firefox, подкрепя разширяването.
Най-интересният Ключът тук - това content_scripts. която разказва Firefox, за да заредите скрипт на уеб страница, чийто URL отговаря на зададена схема. В нашия случай, Ви молим да изтеглите Firefox скрипт, наречен "borderify.js" на всички HTTP или HTTPS страници, получени "mozilla.org" или някой от неговите поддомейни.
В някои случаи е необходимо да се уточни ID за вашите допълнения. Ако трябва да посочите допълненията ID включва ключови приложения в manifest.json и определя неговите свойства gecko.id:
икони / гранично-48.png
Добавянето трябва да бъде икона (икона). Тази икона ще бъде показана в списъка на добавки в управлението на добавките на. Нашата файл manifest.json казва, че иконата ще бъде в файла "икони / граница-48.png".
Създаване на директория (папка) "икони" вътре директория "borderify". Запишете го в иконата под името "граничен 48.png". Можете да използвате иконата от нашия пример. която е взета от набор от Google Материал дизайн икони и се използва по лиценз на Creative Commons Attribution-Споделяне на споделеното.
Можете да използвате персонализирана икона. Нейният размер трябва да е 48x48 пиксела. Можете да използвате и размера на иконата 96x96 пиксела за показване на висока резолюция монитори. В този случай, трябва да го посочите като собственост на "96" обект "икони" в manifest.json:
Можете също да създадете икона в SVG формат и ще бъде оразмерена правилно.
borderify.js
На последно място, създаване на директория "borderify" файл с име "borderify.js" и постави следния код:
Този скрипт ще бъдат вградени в една страница, която съответства на модела, определен в ключови content_scripts manifest.json по делото. Този скрипт има директен достъп до целия документ, тъй като, ако е бил натоварен със самата страница.
Първо, проверете внимателно дали сте поставили правилно файловете и да им даде правилните имена:
Като се започне с пускането на Firefox 45, можете временно да зададете WebExtension от локален диск.
Отворете страницата "за: отстраняване на грешки", натиснете "Заредете Временно добавките" и изберете файла manifest.json:
Сега инсталирали добавка и ще остане в браузъра, преди да бъде рестартиран.
За да проверите, отидете на страницата "за: добавките", за да отворите управлението на добавките. Трябва да видите неговото допълнение към името и иконата:
Също така, можете да стартирате WebExtension от командния ред, с помощта на уеб-вътр.
тестване
Сега отидете на страницата на домейн "mozilla.org" и трябва да видите червена линия в страницата:
Експеримент малко. Промяна на цвета на рамката или нещо друго на със съдържанието на страницата. След променили скрипта ще бъде спасен, и страницата се презарежда, ще видите промяната веднага:
Имайте предвид, че след промените в manifest.json файлове, можете ръчно да рестартирате допълнение ви. В момента, това означава, че трябва да се рестартира на Firefox, и после отново да изтеглите допълнение им към "относно: откриване на грешки" страница. Ние работим за подобряване на този процес.
Опаковане и издателство
Че други хора могат да използват допълнение си, трябва да го опаковат. Firefox Добавки в пакетиран вид са от главната директория на файлове, които са често срещани ZIP файлове с разширение "от главната директория".
Когато опаковане, имайте предвид следното: в ZIP архива трябва да бъде само файловете, които не съдържат своя режисьор ( "borderify" не трябва да влязат в архива). За да се създаде правилната XPI файл от вашите добавки, отидете в директорията "borderify" в командния ред и изпълнете следната команда:
цип -r. /borderify.xpi *
Започвайки с Firefox 43 всички изменения трябва да бъдат подписани преди те ще бъдат инсталирани в браузъра. Можете да премахнете това ограничение само в Firefox Developer Edition или Firefox Nightly като изпълните следните стъпки:
- отидете за страницата: довереник на Firefox
- използване на низа за търсене е намерена xpinstall.signatures.required
- кликнете два пъти върху този имот или да използвате локалното меню (като щракнете с десния бутон на мишката), изберете "Превключване", за да настроите стойността на неверни.
Каква е следващата стъпка?
Сега, когато имате идея за развитието на Firefox добавки, можете да:
Свързани статии