diff options
Diffstat (limited to 'files/de/mozilla/firefox/releases/3/updating_extensions/index.html')
| -rw-r--r-- | files/de/mozilla/firefox/releases/3/updating_extensions/index.html | 232 |
1 files changed, 232 insertions, 0 deletions
diff --git a/files/de/mozilla/firefox/releases/3/updating_extensions/index.html b/files/de/mozilla/firefox/releases/3/updating_extensions/index.html new file mode 100644 index 0000000000..409fc00546 --- /dev/null +++ b/files/de/mozilla/firefox/releases/3/updating_extensions/index.html @@ -0,0 +1,232 @@ +--- +title: Erweiterungen für Firefox 3 aktualisieren +slug: Erweiterungen_für_Firefox_3_aktualisieren +tags: + - Firefox 3 +translation_of: Mozilla/Firefox/Releases/3/Updating_extensions +--- +<div><section class="Quick_links" id="Quick_Links"> + <ol> + <li class="toggle"> + <details> + <summary>Firefox developer release notes</summary> + <ol> + <li><a href="/de/docs/Mozilla/Firefox/Releases">Firefox developer release notes</a></li> + </ol> + </details> + </li> + <li class="toggle"> + <details> + <summary>Add-ons</summary> + <ol> + <li><a href="/de/Add-ons/WebExtensions">Browser extensions</a></li> + <li><a href="/de/Add-ons/Themes">Themes</a></li> + </ol> + </details> + </li> + <li class="toggle"> + <details> + <summary>Firefox internals</summary> + <ol> + <li><a href="/de/docs/Mozilla/">Mozilla project</a></li> + <li><a href="/de/docs/Mozilla/Gecko">Gecko</a></li> + <li><a href="/de/docs/Mozilla/Firefox/Headless_mode">Headless mode</a></li> + <li><a href="/de/docs/Mozilla/JavaScript_code_modules">JavaScript code modules</a></li> + <li><a href="/de/docs/Mozilla/js-ctypes">JS-ctypes</a></li> + <li><a href="/de/docs/Mozilla/MathML_Project">MathML project</a></li> + <li><a href="/de/docs/Mozilla/MFBT">MFBT</a></li> + <li><a href="/de/docs/Mozilla/Projects">Mozilla projects</a></li> + <li><a href="/de/docs/Mozilla/Preferences">Preference system</a></li> + <li><a href="/de/docs/Mozilla/WebIDL_bindings">WebIDL bindings</a></li> + <li><a href="/de/docs/Mozilla/Tech/XPCOM">XPCOM</a></li> + <li><a href="/de/docs/Mozilla/Tech/XUL">XUL</a></li> + </ol> + </details> + </li> + <li class="toggle"> + <details> + <summary>Building and contributing</summary> + <ol> + <li><a href="/de/docs/Mozilla/Developer_guide/Build_Instructions">Build instructions</a></li> + <li><a href="/de/docs/Mozilla/Developer_guide/Build_Instructions/Configuring_Build_Options">Configuring build options</a></li> + <li><a href="/de/docs/Mozilla/Developer_guide/Build_Instructions/How_Mozilla_s_build_system_works">How the build system works</a></li> + <li><a href="/de/docs/Mozilla/Developer_guide/Source_Code/Mercurial">Mozilla source code</a></li> + <li><a href="/de/docs/Mozilla/Localization">Localization</a></li> + <li><a href="/de/docs/Mozilla/Mercurial">Mercurial</a></li> + <li><a href="/de/docs/Mozilla/QA">Quality assurance</a></li> + <li><a href="/de/docs/Mozilla/Using_Mozilla_code_in_other_projects">Using Mozilla code in other projects</a></li> + </ol> + </details> + </li> + </ol> +</section></div> + +<p> Dieser Artikel liefert nützliche Informationen für Entwickler, die ihre Erweiterungen aktualisieren möchten, um eine einwandfreie Funktion unter Firefox 3 zu gewährleisten.</p> + +<p>Vorweg eine hilfreiche Anmerkung: Wenn die einzig notwendige Änderung an der Erweiterung der Eintrag <code>maxVersion</code> im Installationsmanifest ist und die Erweiterung auf <a class="link-https" href="https://addons.mozilla.org">addons.mozilla.org</a> bereitgestellt wird, ist es nicht nötig eine neue Version der Erweiterung zu veröffentlichen. Im »Developer Control Panel« auf <abbr title="Addons.Mozilla.Org">AMO</abbr> kann die <code>maxVersion</code>, ohne einen neuen Upload, eingestellt werden. Dadurch kann auch vermieden werden, dass die Erweiterung nochmal überprüft werden muss.</p> + +<h3 id="Schritt_1_Installationsmanifest_aktualisieren">Schritt 1: Installationsmanifest aktualisieren</h3> + +<p>Der erste Schritt - und für die meisten Erweiterungen der einzig Nötige - ist eine Aktualisierung der <a href="/de/Installationsmanifest" title="de/Installationsmanifest">Installationsmanifestdatei</a>, <code>install.rdf</code>, um die Erweiterung als Firefox 3 kompatibel zu kennzeichnen.</p> + +<p>Als erstes muss die Zeile zur Kennzeichnung der maximal kompatiblen Firefox-Version gefunden werden (welche für Firefox 2 so aussehen sollte):</p> + +<pre class="eval"> <span class="nowiki"><em:maxVersion>2.0.0.*</em:maxVersion></span> +</pre> + +<p>Um als Firefox 3 kompatibel zu gelten, reicht die folgende Änderung:</p> + +<pre class="eval"> <span class="nowiki"><em:maxVersion>3.0.*</em:maxVersion></span> +</pre> + +<p>Danach muss die Erweiterung neu installiert werden.</p> + +<p>Dabei sollte darauf geachtet werden, dass Firefox 3 keine extra ".0" in der Versionsnummer hat, anstatt "3.0.0.*, sollte nur "3.0.*" verwendet werden.</p> + +<p>Es gab (und es wird weiterhin welche geben) eine Reihe von API Veränderungen, die dazu führen, dass einige Erweiterungen nicht weiter funktionieren. Es wird an einer kompletten Liste gearbeitet, die diese Veränderungen aufzählt.</p> + +<div class="note"><strong>Hinweis:</strong> Wenn die Erweiterung noch immer ein <code><a href="/de/Install.js" title="de/Install.js">Install.js</a></code> Skript, anstatt eines <a href="/de/Installationsmanifest" title="de/Installationsmanifest">Installationsmanifests</a> benutzt, sollte ein Wechsel jetzt getätigt werden. Firefox 3 unterstützt keine <code>install.js</code> Skripte in XPI Dateien mehr.</div> + +<h4 id="Das_Installationsmanifest_lokalisieren">Das Installationsmanifest lokalisieren</h4> + +<p>Firefox 3 führt neue Eigenschaften ein, um <a href="/de/Lokalisierung_von_Erweiterungsbeschreibungen" title="de/Lokalisierung_von_Erweiterungsbeschreibungen">lokalisierte Beschreibungen</a> zu ermöglichen. Die alte Methode funktioniert nach wie vor, auch wenn die neue Firefox-Version erlaubt, sogar dann die lokalisierten Sprachdaten zu nutzen, wenn die Erweiterung deaktiviert oder noch zur Installation vorgesehen ist.</p> + +<h3 id="Schritt_2_Sichere_Updates_zur_Verfügung_stellen">Schritt 2: Sichere Updates zur Verfügung stellen</h3> + +<p>Falls die Erweiterungen selbst bereitgestellt wird und nicht bei <a class="link-https" href="https://addons.mozilla.org">addons.mozilla.org</a> angeboten wird, müssen sichere Updates selbst verwaltet werden. Dazu können die Updates entweder über eine SSL Webseite angeboten werden oder die Updates werden mit einem Kryptographieschlüssel signiert. Weitere Informationen dazu unter: <a href="/de/Erweiterungsversionierung,_Updates_und_Kompatibilität#Sichere_Updates" title="de/Erweiterungsversionierung,_Updates_und_Kompatibilität#Sichere_Updates">Sichere Updates</a>.</p> + +<h3 id="Schritt_3_Mit_geänderten_APIs_umgehen">Schritt 3: Mit geänderten APIs umgehen</h3> + +<p>Mehrere APIs haben sich erheblich geändert. Die wichtigsten davon, die sich auf viele Erweiterungen auswirken, sind:</p> + +<h4 id="DOM" name="DOM">DOM</h4> + + +<p>Nodes from external documents should be cloned using <a href="/de/docs/Web/API/Document/importNode" title="Die Document-Methode importNode() erzeugt eine neue Kopie eines konkreten Knotens (Node) oder Dokumenten-Fragments (DocumentFragment) eines anderen Dokuments, so dass diese dann in das aktuelle Dokument eingefügt werden kann. "><code>document.importNode()</code></a> (or adopted using <a href="/de/docs/Web/API/Document/adoptNode" title="Überträgt einen Knoten. Der Knoten und sein Unterbaum werden aus dem Dokument, in dem sie sich befinden entfernt (so vorhanden), und sein ownerDocument wird zu dem aktuellen Dokument geändert. Der Knoten kann dann in das aktuelle Dokument eingefügt werden."><code>document.adoptNode()</code></a>) before they + can be inserted into the current document. For more on the <a class="new" href="/de/docs/Web/API/Node/ownerDocument" rel="nofollow" title="Die Beschreibung hierüber wurde bisher noch nicht geschrieben. Bitte überlege, mitzuwirken!"><code>Node.ownerDocument</code></a> issues, see the + <a class="external" href="http://www.w3.org/DOM/faq.html#ownerdoc" rel="noopener">W3C DOM FAQ</a>.</p> + + <p>Firefox doesn't currently enforce this rule (it did for a while during the development of Firefox 3, but too many + sites break when this rule is enforced). We encourage Web developers to fix their code to follow this rule for + improved future compatibility.</p> + +<h4 id="Lesezeichen_Chronik">Lesezeichen & Chronik</h4> + +<p>Falls die Erweiterung in irgendeiner Art auf Lesezeichen oder die Chronik zugreift, sind umfangreichere Änderungen nötig, um die Kompatibilität mit Firefox 3 zu gewährleisten. Die alte API zum Zugriff auf diese Informationen wurde durch die neue <a href="/de/Places" title="de/Places">Places</a> Architektur ersetzt. Im <a href="/de/Leitfaden_zur_Places_Migration" title="de/Leitfaden_zur_Places_Migration">Leitfaden zur Places Migration</a> finden sich dazu weitere Details, auch wie die bestehende Erweiterung auf die »Places« API aktualisiert werden kann.</p> + +<h4 id="Download-Manager">Download-Manager</h4> + +<p>Die Download-Manager API hat sich durch den Wechsel vom RDF Datenspeicher zur <a href="/de/Storage" title="de/Storage">Storage</a> API ein wenig geändert. Der Wechsel sollte relativ einfach durchzuführen sein. Außerdem hat sich die API zum Überwachen des Downloadfortschritts geändert, um mehrere Download-Manager Listeners zu unterstützen. Unter <code><a href="/de/docs/XPCOM_Interface_Referenz/nsIDownloadManager" title="">nsIDownloadManager</a></code>, <code><a href="/de/docs/XPCOM_Interface_Referenz/nsIDownloadProgressListener" title="">nsIDownloadProgressListener</a></code> und <a href="/de/Downloads_überwachen" title="de/Downloads_überwachen">Downloads überwachen</a> sind weitere Informationen verfügbar.</p> + +<h4 id="Passwort-Manager">Passwort-Manager</h4> + +<p>Wenn die Erweiterung den Passwort-Manager benutzt, um auf Anmeldeinformationen zuzugreifen muss die Erweiterung auf die neue Login Manager API umgestellt werden.</p> + +<ul> + <li>Der Artikel <a href="/de/Verwendung_von_nsILoginManager">Verwendung von nsILoginManager</a> enthält Beispiele. Darunter findet sich auch eine Demo wie die Erweiterung sowohl den Passwort-Manager als auch den Login-Manager benutzen kann. Dadurch kann die Erweiterung von Firefox 3 und von früheren Versionen genutzt werden.</li> + <li><code><a href="/de/nsILoginInfo" title="de/nsILoginInfo">nsILoginInfo</a></code></li> + <li><code><a href="/de/nsILoginManager" title="de/nsILoginManager">nsILoginManager</a></code></li> +</ul> + +<p>Es kann aber auch der integrierte Speicher des Passwort-Managers überschrieben werden, falls eine eigene Implementierung in der Erweiterung angeboten werden soll. Weitere Details unter <a href="/de/Ein_Login-Manager_Speichermodul_erstellen" title="de/Ein_Login-Manager_Speichermodul_erstellen">Ein Login-Manager Speichermodul erstellen</a>.</p> + +<h4 id="Popups_Menü_Kontextmenü_Tooltips_und_Eingabefelder">Popups (Menü, Kontextmenü, Tooltips und Eingabefelder)</h4> + +<p>Das XUL Popup-System wurde im Firefox 3 stark verändert. Das Popup-System umfasst Hauptmenüs, Kontextmenüs und Popup Eingabefelder. Der Artikel zu <a href="/de/XUL/Popup_Leitfaden" title="de/XUL/Popup_Leitfaden">Popups</a> beschreibt detailliert wie das System funktioniert. Zu beachten ist außerdem, dass <code>popup.<span id="m-showPopup"><code><a href="https://developer.mozilla.org/de/docs/Mozilla/Tech/XUL/Methoden/showPopup">showPopup</a></code></span></code> zugunsten von <code>popup.<span id="m-openPopup"><code><a href="https://developer.mozilla.org/de/docs/Mozilla/Tech/XUL/Methoden/openPopup">openPopup</a></code></span></code> und <code>popup.<span id="m-openPopupAtScreen"><code><a href="https://developer.mozilla.org/de/docs/Mozilla/Tech/XUL/Methoden/openPopupAtScreen">openPopupAtScreen</a></code></span></code> als veraltet gekennzeichnet wurde.</p> + +<h4 id="Autovervollst.C3.A4ndigung" name="Autovervollst.C3.A4ndigung">Autovervollständigung</h4> + +<p>Die <code><a href="/de/NsIAutoCompleteController#Enter_behandeln.28.29" title="de/NsIAutoCompleteController#Enter_behandeln.28.29">handleEnter()</a></code> Methode im <code><a href="/de/docs/XPCOM_Interface_Referenz/nsIAutoCompleteController" title="">nsIAutoCompleteController</a></code> Interface wurde um ein Argument erweitert. Dieses kennzeichnet, ob der abgesendete Text im Autovervollständigungspopup ausgewählt wurde oder, ob der Benutzer nach seiner Eingabe »Enter« gedrückt hat.</p> + +<h4 id="DOMParser">DOMParser</h4> + +<ul> + <li>Wenn ein <code>DOMParser</code> instanziiert wird, erbt er das vom aufrufenden Code repräsentierte Dokument sowie <code>documentURI</code> und <code>baseURI</code> des aufrufenden Fensters.</li> + <li>Hat der Aufrufende Code UniversalXPConnect Privilegien, kann er Parameter an <code>new DOMParser()</code> übergeben. Werden weniger als drei Parameter übergeben werden die übrig gebliebenen standardmäßig mit <code>null</code> belegt. + <ul> + <li>Der erste Parameter ist das zu parsende Dokument und überschreibt den für gewöhnlich geerbten Standardwert.</li> + <li>Der zweite Parameter enthält <code>documentURI</code>.</li> + <li>Der dritte Parameter enthält <code>baseURI</code>.</li> + </ul> + </li> + <li>Falls ein <code>DOMParser</code> durch einen Auftrag aufgerufen wird, wie z.B. durch <code>createInstance()</code>, nicht die <code>init()</code> Methode des DOM-Parsers aufgerufen wird und versucht wird eine Parseroperation zu starten, wird der <code>DOMParser</code> automatisch mit einem <code>null</code> Dokument und <code>null</code> Verweisen auf <code>documentURI</code> und <code>baseURI</code> erstellt und instanziiert.</li> +</ul> + +<h4 id="Keine_weitere_Verwendung_der_internen_String_API">Keine weitere Verwendung der internen String API</h4> + +<p>Die interne String API wird nicht weiter ausgeführt, stattdessen muss die externe String API benutzt werden. Einige nützliche Informationen dazu:</p> + +<ul> + <li><a href="/de/Externe_Strings">Externe Strings</a></li> + <li><a href="/de/XPCOM_Glue">XPCOM Glue</a></li> + <li><a href="/de/Von_interner_Verlinkung_zu_fester_Verlinkung_wechseln">Von interner Verlinkung zu fester Verlinkung wechseln</a></li> +</ul> + +<h4 id="Entfernte_Interfaces">Entfernte Interfaces</h4> + +<p>Folgende Interfaces wurden aus, der im Firefox 3 enthaltenen, Gecko-Engine 1.9 entfernt. Wenn die Erweiterung eines davon nutzt, muss der Code aktualisiert werden:</p> + +<ul> + <li><code>nsIDOMPaintListener</code></li> + <li><code>nsIDOMScrollListener</code></li> + <li><code>nsIDOMMutationListener</code></li> + <li><code>nsIDOMPageTransitionListener</code></li> + <li><code>nsICloseAllWindows</code> (Siehe <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=386200" title='FIXED: SeaMonkey only: no "view cert button" in untrusted cert error dialog'>Bug 386200</a>)</li> +</ul> + +<h3 id="Schritt_4_Auf_Chrome_Änderungen_überprüfen">Schritt 4: Auf <em>Chrome</em> Änderungen überprüfen</h3> + +<p>Es gab einige Veränderungen im <em>Chrome</em>-Layout, die eventuell auch Erweiterungen betreffen.</p> + +<h4 id="Neue_Boxen">Neue Boxen</h4> + +<p>Es wurden kleinere Änderungen an der Oberfläche vorgenommen, die Änderungen an der Erweiterung nötig machen könnten. Eine neue <code>vbox</code> mit dem Namen »browser-bottombox« wurde hinzugefügt, welche die »Find Bar« und die »Status Bar« am unteren Rand des Browsers umschließt. Auch wenn dies nicht die Anzeige selbst beeinflusst, kann dies deine Erweiterung betreffen falls diese »Overlays« verwendet, die Elemente ändern, die relativ zu besagten Elementen positioniert sind.</p> + +<p>Zum Beispiel, wenn vorher etwas überlagert wurde, wie im folgendem Codeschnipsel:</p> + +<pre><window id="main-window"> + <something insertbefore="status-bar" /> +</window> +</pre> + +<p>Sollte es nun so überlagert werden:</p> + +<pre><vbox id="browser-bottombox"> + <something insertbefore="status-bar" /> +</vbox> +</pre> + +<p>Oder, um Firefox 2 und Firefox 3 gleichermaßen zu behandeln, kann der folgende Code zum Einsatz kommen:</p> + +<pre><window id="main-window"> + <vbox id="browser-bottombox" insertbefore="status-bar"> + <something insertbefore="status-bar" /> + </vbox> +</window> +</pre> + +<h4 id="Veränderte_Boxen">Veränderte Boxen</h4> + +<p>Erweiterungen, die auf die »appcontent« Box überlagern wollten, versuchten dies über das Floaten von Chrome-Inhalten über Dokumenteninhalten. Jetzt wird dann nicht mehr angezeigt. Die Erweiterung sollte auf das neue XUL panel Element aktualisiert werden. Falls es erwünscht ist, dass das Panel nach einer Verzögerung weiter angezeigt wird, sollte <code>noautohide</code> auf <code>true</code> gesetzt werden.</p> + +<h3 id="Weitere_Änderungen">Weitere Änderungen</h3> + +<p><em>Einfache Änderungen, die Sie bei der Aktualisierung Ihrer Erweiterung auf Firefox 3 machen mussten, können Sie hier gerne eintragen!</em></p> + +<ul> + <li><code><a class="external" rel="freelink">chrome://browser/base/utilityOverlay.js</a></code> wird aus Sicherheitsgründen nicht länger unterstützt. Falls dies vorher verwendet wurde, sollte auf <code><a class="external" rel="freelink">chrome://browser/content/utilityOverlay.js</a></code>. gewechselt werden.</li> + <li>Bei <code><a href="/de/docs/XPCOM_Interface_Referenz/nsIAboutModule" title="">nsIAboutModule</a></code> Implementierungen wird nun <code>getURIFlags</code> Methode benötigt. Siehe <a href="https://dxr.mozilla.org/mozilla-central/source/netwerk/protocol/about/public/nsIAboutModule.idl" rel="custom">nsIAboutModule.idl</a> für weitere Dokumentation. Das betrifft Erweiterungen, die neue <code>about:</code> URIs verwenden. (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=337746" title='FIXED: [FIX]Move "safe about" hardcoding out of security manager'>Bug 337746</a>)</li> + <li>Das <code><a href="/de/docs/Mozilla/Tech/XUL/tabbrowser" title="tabbrowser">tabbrowser</a></code> Element ist kein Teil mehr von »toolkit« (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=339964" title="FIXED: move tabbrowser.xml out of mozilla/toolkit and into mozilla/browser">Bug 339964</a>). Das bedeutet, dass dieses Element nicht länger für XUL Anwendungen und Erweiterungen verfügbar ist. Es wird weiterhin in Firefox' Hauptfenster (browser.xul) benutzt.</li> + <li>Veränderungen an <a href="/de/NsISupports_proxies" title="de/NsISupports_proxies">nsISupports proxies</a> und möglicherweise ab Thread-bezogenen Interfaces muss noch dokumentiert werden.</li> + <li>Wenn XML Prozessanweisungen wie <code><?xml-stylesheet ?></code> in XUL Dateien verwendet werden, sollten Änderungen durch <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=319654" title="FIXED: Processing instructions in XUL are not added to the content model">Bug 319654</a> beachtet werden: + <ol> + <li>XML Prozessanweisungen werden nun in das XUL DOM hinzugefügt. Das bedeutet, dass <a href="/de/docs/Web/API/Document/firstChild" title="Die Beschreibung hierüber wurde bisher noch nicht geschrieben. Bitte überlege, mitzuwirken!"><code>document.firstChild</code></a> nicht unbedingt mehr das Root-Element sein muss. Wenn das Wurzelelement angesprochen werden muss sollte <a href="/de/docs/Web/API/Document/documentElement" title="Lesbar, nicht schreibbar"><code>document.documentElement</code></a> verwendet werden.</li> + <li><code><?xml-stylesheet ?></code> und <code><?xul-overlay ?></code> Prozessanweisungen haben jetzt außerhalb des Dokumentprologs keinen Effekt mehr.</li> + </ol> + </li> + <li><code>window.addEventListener("load", myFunc, true)</code> wird nicht ausgeführt, wenn Webinhalte geladen werden (Browser eine Seite lädt). Durch <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=296639" title="FIXED: Split windows into an inner and outer object">Bug 296639</a> wurde die Art und Weise in der innere und äußere Fenster kommunizieren verändert. Ein einfacher Fix, der auch in Firefox 2 funktioniert: <code>gBrowser.addEventListener("load", myFunc, true)</code> wie <a href="/de/Codeschnipsel/Tabbed_browser#Detecting_page_load">hier</a> beschrieben.</li> + <li><code>content.window.getSelection()</code> gibt ein Objekt zurück (welches durch <code>toString()</code> zu einem String umgewandelt werden kann), im Gegensatz zu dem jetzt veraltetem <code>content.document.getSelection()</code>, welches einen String zurück gibt.</li> + <li><code>event.preventBubble()</code> war Firefox 2 in deprecated und wurde in Firefox 3 entfernt. Es sollte <a href="/de/DOM/event.stopPropagation" title="de/DOM/event.stopPropagation"><code>event.stopPropagation()</code></a> verwendet werden, was in Firefox 2 ebenso funktioniert.</li> + <li>Timers, die durch <code>setTimeout()</code> initialisiert wurden, werden nun von modalen Fenstern, durch den Fix von <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=52209" title="FIXED: JS timers can fire while a modal dialog is open">Bug 52209</a>, geblockt. Es könnte <code>nsITimer</code> stattdessen verwendet werden.</li> + <li>Wenn die Erweiterung einer nicht vertrauten Quelle (z.B. eine Webseite) Zugang zu Chrome zulassen muss, sollte die neue <a href="/de/Chrome_Registration#contentaccessible" title="de/Chrome_Registration#contentaccessible"><code>contentaccessible</code> Flag</a> benutzt werden.</li> +</ul> |