From 6203d54d818a6656ab1065554d26f0785d5621be Mon Sep 17 00:00:00 2001
From: julieng O Gerenciador de complementos dá acesso aos complementos a fim de determinar o que está disponível, instalar, remover, desativar e atualizar. Extensões adicionam novas funcionalidades para aplicativos da Mozilla como Firefox e Thunderbird. Eles podem adicionar novos recursos ao navegador, como um jeito diferente de gerenciar as abas, e eles podem modificar o conteúdo da web para aperfeiçoar a usabilidade ou segurança sites específicos. Há três tipos de técnicas diferentes que você pode utilizar para construir uma extensão: Add-on baseado em extensões SDK, extensões restartless inicializadas manualmente e extensões overlay. Se você puder, é aconselhável utilizar o Add-on SDK, que usa o mecanismo de extensão restartless mas simplifica determinadas tarefas e limpa depois de si mesmo. Se o Add-on SDK não é suficiente para as suas necessidades, implemente uma extensão restartless manual no lugar. Para obter mais informações sobre como escolher qual a técnica de usar, leia esta comparação. Para obter mais informações sobre como escolher qual a técnica de usar, leia esta comparação. Não importa como você desenvolve uma extensão, existem algumas orientações que você pode seguir para ajudar a garantir que sua extensão fornece uma experiência tão boa para o usuário o quão possível. A maioria das documentações assume que você está desenvolvendo para o Firefox Desktop. Se você está desenvolvendo para algum outro aplicativo baseado no Gecko, há diferenças importantes que você precisa saber sobre. Os temas são add-ons que personalizam a IU do aplicativo. Existem dois tipos de temas: temas leves e temas completos. Temas Leves são muito mais simples de implementar do que temas completos, mas fornece a personalização muito limitada. Com Temas Completos você pode fazer modificações mais profundas na IU. A documentação para temas completos é fora da data, mas está ligada a aqui como uma possível base para a documentação atualizada. Com Temas Completos você pode fazer modificações mais profundas na IU. A documentação para temas completos é fora da data, mas está ligada a aqui como uma possível base para a documentação atualizada. Plugins de Search Engine são um tipo simples e muito específico de add-on: eles adicionam novos mecanismos de busca para barra de pesquisa do navegador.
Extensões
+
+
Desenvolva extensões que não requer a reinicialização do navegador.
- Extensões que requerem a reinicialização do navegador para instalar, geralmente usando overlays XUL.
+ Extensões que requerem a reinicialização do navegador para instalar, geralmente usando overlays XUL.Práticas Recomendadas
-
-Aplicativo específico
-
-
Temas
Outros tipos de complementos
- Plugins ajuda a aplicação a entender o conteúdo web que não é suportado nativamente. Plugins NPAPI são uma tecnologia antiga e os novos sites não devem usá-las. Em geral, os plugins não estão disponíveis na maioria dos sistemas móveis modernos, e os sites devem evitar usar plugins.
{{Compat("webextensions.api.bookmarks")}}
-A sessão "Chrome incompatibilities" está incluso no https://developer.mozilla.org/en-US/Add-ons/WebExtensions/Chrome_incompatibilities usando a macro WebExtChromeCompat.
- -Se precisar atualizar este conteúdo, edite https://developer.mozilla.org/en-US/Add-ons/WebExtensions/Chrome_incompatibilities, então recarregue a página para ver suas alterações.
-{{WebExtExamples("h2")}}
// Copyright 2015 The Chromium Authors. All rights reserved. +// Copyright 2015 The Chromium Authors. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -115,5 +109,4 @@Compatibilidade com navegadores
// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -
{{Compat("webextensions.api.browserAction")}}
-A sessão "Chrome incompatibilities" está inclusa em https://developer.mozilla.org/en-US/Add-ons/WebExtensions/Chrome_incompatibilities usando a macro WebExtChromeCompat.
- -Se precisar atualizar este conteúdo edite https://developer.mozilla.org/en-US/Add-ons/WebExtensions/Chrome_incompatibilities, então recarregue esta página para visualizar suas alterações.
-{{WebExtExamples("h2")}}
// Copyright 2015 The Chromium Authors. All rights reserved. +// Copyright 2015 The Chromium Authors. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -124,5 +118,4 @@Compatibilidade com navegadores
// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -
{{Compat("webextensions.api.browsingData", 2)}}
- -{{WebExtExamples("h2")}}
// Copyright 2015 The Chromium Authors. All rights reserved. +// Copyright 2015 The Chromium Authors. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -114,5 +108,4 @@Compatibilidade com navegadores
// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -
// Copyright 2015 The Chromium Authors. All rights reserved. +// Copyright 2015 The Chromium Authors. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -79,5 +79,4 @@Compatibilidade com navegadores
// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -
{{Compat("webextensions.api.cookies")}}
@@ -131,7 +124,7 @@// Copyright 2015 The Chromium Authors. All rights reserved. +// Copyright 2015 The Chromium Authors. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -158,5 +151,4 @@Compatibilidade com navegadores
// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -
// Copyright 2015 The Chromium Authors. All rights reserved. +// Copyright 2015 The Chromium Authors. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -201,5 +201,4 @@Compatibilidade com navegadores
// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -
// Copyright 2015 The Chromium Authors. All rights reserved. +// Copyright 2015 The Chromium Authors. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -219,5 +219,4 @@Compatibilidade com navegadores
// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -
Se você tem dúvidas ou sugestões, ou precisa de ajuda para migrar um complemento legado para usar APIs WebExtensions, pode entrar em contato conosco pela newsletter de desenvolvimento de complementos ou #webextensions no IRC.
-+"web_accessible_resources": [ "images/my-image.png" ]@@ -46,7 +46,7 @@Using web_accessible_resources
For example, suppose your extension includes an image file at images/my-image.png, like this:
-my-extension-files/ +my-extension-files/ manifest.json my-background-script.js images/ @@ -54,11 +54,11 @@Using web_accessible_resources
To enable a web page to use an
-<img>
element whosesrc
attribute points to this image, you would specifyweb_accessible_resources
like this:"web_accessible_resources": ["images/my-image.png"]+"web_accessible_resources": ["images/my-image.png"]The file is then available using a URL like:
-moz-extension://<extension-UUID>/images/my-image.png"+moz-extension://<extension-UUID>/images/my-image.png"@@ -68,7 +68,7 @@
<extension-UUID>
is not your extension's ID. This ID is randomly generated for every browser instance. This prevents websites from fingerprinting a browser by examining the extensions it has installed.Using web_accessible_resources
The recommended approach to obtaining the URL of the resource is to use
-runtime.getURL
passing the path relative to manifest.json, for example:browser.runtime.getURL("images/my-image.png"); +browser.runtime.getURL("images/my-image.png"); // something like: // moz-extension://944cfddf-7a95-3c47-bd9a-663b3ce8d699/images/my-image.png@@ -78,7 +78,7 @@Wildcards
-
web_accessible_resources
entries can contain wildcards. For example, the following entry would also work to include the resource at "images/my-image.png":"web_accessible_resources": ["images/*.png"]+"web_accessible_resources": ["images/*.png"]Security
@@ -86,7 +86,7 @@Security
Example
-"web_accessible_resources": ["images/my-image.png"]+"web_accessible_resources": ["images/my-image.png"]Make the file at "images/my-image.png" web accessible.
diff --git a/files/pt-br/mozilla/add-ons/webextensions/user_interface/context_menu_items/index.html b/files/pt-br/mozilla/add-ons/webextensions/user_interface/context_menu_items/index.html index 466fac6f8239db..6d34a5ee3c6aa3 100644 --- a/files/pt-br/mozilla/add-ons/webextensions/user_interface/context_menu_items/index.html +++ b/files/pt-br/mozilla/add-ons/webextensions/user_interface/context_menu_items/index.html @@ -46,7 +46,7 @@Especificando itens do menu de
Ícones
-Para mais detalhes sobre como criar ícones para usar no seu menu de contexto, veja Iconography na documentação Photon Design System.
+Para mais detalhes sobre como criar ícones para usar no seu menu de contexto, veja Iconography na documentação Photon Design System.
Exemplos
diff --git a/files/pt-br/mozilla/add-ons/webextensions/what_are_webextensions/index.html b/files/pt-br/mozilla/add-ons/webextensions/what_are_webextensions/index.html index 854a44c81241a8..26e70ea04cc1a3 100644 --- a/files/pt-br/mozilla/add-ons/webextensions/what_are_webextensions/index.html +++ b/files/pt-br/mozilla/add-ons/webextensions/what_are_webextensions/index.html @@ -7,16 +7,16 @@Extensões são bits de código que modificam a funcionalidade do navegador. Eles são escritos usando as tecnologias padrões da Web - JavaScript, HTML e CSS - além de APIs JavaScript dedicadas. Entre outras coisas, extensões podem adicionar novas funcionalidades para o navegador, ou mudar sua aparência, ou o conteúdo de páginas particulares.
-Extensões para Firefox são construídas usando WebExtensions APIs, um sistema multi-navegador (cross-browser) para o desenvolvimento de extensões. Para uma maior portabilidade, a API é compatível com a extension API, suportada pelo Google Chrome e pelo Opera. Extensões escritas para esses navegadores, na maioria dos casos, vão rodar no Firefox ou Microsoft Edge com poucas mudanças. A API é também totalmente compatível com o multiprocess Firefox.
+Extensões para Firefox são construídas usando WebExtensions APIs, um sistema multi-navegador (cross-browser) para o desenvolvimento de extensões. Para uma maior portabilidade, a API é compatível com a extension API, suportada pelo Google Chrome e pelo Opera. Extensões escritas para esses navegadores, na maioria dos casos, vão rodar no Firefox ou Microsoft Edge com poucas mudanças. A API é também totalmente compatível com o multiprocess Firefox.
-No passado, você poderia desenvolver extensões para Firefox usando um dos três métodos diferentes: XUL/XPCOM overlays, bootstrapped extensions ou o Add-on SDK. A partir do fim de Novembro de 2017, WebExtensions APIs será o único meio de desenvolver extensões para Firefox, e os outros métodos serão descontinuados.
+No passado, você poderia desenvolver extensões para Firefox usando um dos três métodos diferentes: XUL/XPCOM overlays, bootstrapped extensions ou o Add-on SDK. A partir do fim de Novembro de 2017, WebExtensions APIs será o único meio de desenvolver extensões para Firefox, e os outros métodos serão descontinuados.
-Se você tem dúvidas ou sugestões, ou precisa de ajuda para migrar um add-on antigo para o WebExtensions APIs, você pode entrar em contato conosco pela dev-addon mailing list ou pelo canal #extdev no IRC.
+Se você tem dúvidas ou sugestões, ou precisa de ajuda para migrar um add-on antigo para o WebExtensions APIs, você pode entrar em contato conosco pela dev-addon mailing list ou pelo canal #extdev no IRC.
Próximos passos
Aprenda a criar complementos para Firefox, como desenvolver e compilar o Firefox, como funciona internamente o Firefox e subprojetos.
-Notas de versão focada em desenvolvedores; aprenda quais são os novos recursos para ambos Web sites e add-on que chegam a cada versão do Firefox.
-Encontre informações detalhadas sobre o funcionamento do Firefox e o seu sistema de versões, assim você poderá encontrar o seu caminho no código.
-Nosso guia para desenvolvedores provê tutoriais detalhados de como obter e compilar o código fonte do Firefox, como se encontrar, e como contribuir para o projeto.
-isolate-override
value ({{bug(1249497)}}).