Chrome-Erweiterungen verbessern die Nutzererfahrung im Browser. Dazu verwenden Sie Chrome APIs, für die bestimmte Berechtigungen erforderlich sind. Einige Berechtigungen sind weniger aufdringlich und zeigen keine Warnung an. Andere Berechtigungen lösen eine Warnung aus, die die Nutzer zulassen müssen. Auf dieser Seite finden Sie Richtlinien zum Umgang mit Berechtigungswarnungen. Spezifische Warnungen sind in den Berechtigungen unter der Berechtigung aufgeführt, für die sie gelten.
![Beispiel für Berechtigungswarnungen, die angezeigt werden, wenn der Nutzer eine neue Erweiterung hinzufügt](https://developer.chrome.google.cn/static/docs/extensions/develop/concepts/permission-warnings/image/example-permission-warni-8d794fb2f9274.png?authuser=6&hl=de)
Wenn eine neue Berechtigung hinzugefügt wird, die eine Warnung auslöst, wird die Erweiterung deaktiviert, bis der Nutzer die neue Berechtigung akzeptiert. Wie Sie dieses Verhalten testen können, erfahren Sie unter Berechtigungen aktualisieren.
![Beispiel für eine Erweiterung, die deaktiviert ist, bis der Nutzer die neue Berechtigung akzeptiert.](https://developer.chrome.google.cn/static/docs/extensions/develop/concepts/permission-warnings/image/example-an-extension-is-6772580db51de.gif?authuser=6&hl=de)
Für einige Berechtigungen werden in Kombination mit anderen Berechtigungen möglicherweise keine Warnungen angezeigt. Die Warnung "tabs"
wird beispielsweise nicht angezeigt, wenn die Erweiterung auch "<all_urls>"
anfordert.
Best Practices
Berechtigungswarnungen beschreiben die Funktionen, die eine API gewährt. Einige Warnungen sind jedoch schwerer zu verstehen als andere. Die Wahrscheinlichkeit, dass Nutzer Erweiterungen installieren, ist höher:
- Relevante Berechtigungen anfordern
- Erweiterungen sollen einem einzigen Zweck dienen und der Richtlinie zur Verwendung von Berechtigungen entsprechen. Fordern Sie nur Berechtigungen an, die die Hauptfunktion der Erweiterung unterstützen.
- Optionale Berechtigungen verwenden
- Verbessern Sie das Onboarding, indem Sie Berechtigungen zur Laufzeit anfordern. So können Sie mehr Kontext für eine bestimmte Berechtigung bereitstellen und Nutzer auswählen, welche Funktionen sie aktivieren möchten. Weitere Informationen zur Implementierung finden Sie unter Permissions API.
- Die Berechtigung „activeTab“ verwenden
- Bei dieser Berechtigung wird keine Warnung zu einer Berechtigung angezeigt. Er gewährt der Website, auf der sich der Nutzer befindet, eine temporäre Hostberechtigung. Weitere Informationen finden Sie unter Informationen zur Berechtigung „activeTab“.
Warnungen ansehen
Sie haben folgende Möglichkeiten, die Berechtigungswarnungen einer Erweiterung aufzurufen:
Test-Tool für die Aktualisierung von Erweiterungen verwenden
Hinweis
- Installieren Sie Node.js und NPM.
- Chromium installieren
- Klonen Sie das Repository extension-update-testing-tool.
- Führen Sie
npm install
im Stammverzeichnis des Repositorys aus.
Verwendung des Tools
- Führen Sie
npm start
aus. - Öffnen Sie den lokalen Server in Chromium unter http://localhost:8080.
- Ziehen Sie eine entpackte Erweiterung (Ordner oder ZIP-Datei) auf die Seite.
- Folgen Sie der Anleitung unter „Manuell installieren“, um die Erweiterung herunterzuladen und zu installieren.
Durch manuelles Packen der Erweiterung
- Zu
chrome://extensions
wechseln - Entwicklermodus aktivieren
- Klicken Sie auf Erweiterung packen.
Abbildung 3: Aktivierung des Entwicklermodus auf der Seite zum Verwalten von Erweiterungen - Geben Sie im Feld für das Stammverzeichnis der Erweiterung den Pfad zum Ordner der Erweiterung an. Ignorieren Sie bei einem erstmaligen Paket das Feld Privater Schlüssel.
Klicken Sie auf die Schaltfläche Erweiterung packen.
Abbildung 4: Erweiterungspfad angeben Chrome erstellt zwei Dateien, eine
.crx
-Datei und eine.pem
-Datei. Die Datei.pem
enthält den privaten Schlüssel, mit dem die Erweiterung signiert wurde. Merken Sie sich, in welchem Verzeichnis diese Dateien gespeichert wurden.Abbildung 5: Gepackte Erweiterungsdateien Bewahren Sie die Datei
.pem
an einem geheimen und sicheren Ort auf. Sie ist erforderlich, um die Erweiterung zu aktualisieren.Installieren Sie die Datei
.crx
, indem Sie sie auf die Verwaltungsseite der Erweiterung ziehen.Abbildung 6: Zu installierende Datei ablegen Nachdem Sie die
.crx
-Datei abgelegt haben, werden Sie vom Browser gefragt, ob die Erweiterung hinzugefügt werden kann, und es werden Warnungen angezeigt.Abbildung 7: Warnung für die Erweiterung „Neuer Tab“
Berechtigungen aktualisieren
Wenn eine Erweiterung eine neue Berechtigung hinzufügt, die eine Warnung auslöst, kann sie vorübergehend deaktiviert werden. Die Erweiterung wird erst wieder aktiviert, wenn der Nutzer zustimmt, die neue Berechtigung zu akzeptieren.
So prüfen Sie, ob Ihre Erweiterung beim Hinzufügen einer neuen Berechtigung deaktiviert wird:
Aktualisierung mit dem Testtool für die Aktualisierung von Erweiterungen
Bei diesen Schritten wird davon ausgegangen, dass Sie den Server gemäß der Anleitung unter Test-Tool für die Aktualisierung von Erweiterungen verwenden gestartet haben.
Verwendung des Tools
- Fügen Sie eine neue Berechtigung mit Warnung hinzu.
- Geben Sie einen höheren Wert für die Versionsnummer der Erweiterung an.
- Ziehen Sie die entpackte Erweiterung (Ordner oder ZIP-Datei) auf die Seite.
- Öffnen Sie
chrome://extensions
. - Klicken Sie auf die Schaltfläche Aktualisieren.
Erweiterung manuell aktualisieren
- Suchen Sie die Datei
.crx
, die Sie gerade unter Warnungen ansehen erstellt haben. - Benennen Sie sie um oder löschen Sie sie.
- Öffnen Sie die
manifest.json
und fügen Sie alle Berechtigungen hinzu, die eine Warnung auslösen. - Öffnen Sie
chrome://extensions
. Entfernen Sie das zuvor installierte Paket nicht. - Packen Sie die Erweiterung noch einmal, aber fügen Sie diesmal die PEM-Datei in der zweiten Eingabe hinzu.
Abbildung 8: Dialogfeld für die Packungserweiterung mit PEM-Datei. - Ziehen Sie die neue gepackte Erweiterung auf die Seite „Erweiterungsverwaltung“.
Daraufhin wird ein Dialogfeld angezeigt, in dem der Nutzer aufgefordert wird, die neuen Berechtigungen zu akzeptieren.
Abbildung 9: Warnung bei deaktivierter Erweiterung Abbildung 10: Dialogfeld zum Anfordern einer neuen Berechtigung