KappS Wissensdatenbank · FAQ

Paketsichtbarkeit & QUERY_ALL_PACKAGES-Richtlinie

FAQ Berechtigungen & API

1. Das Inventar installierter Apps sind personenbezogene und sensible Nutzerdaten. Ab Android 11 (API 30) filtert die Plattform, welche anderen Pakete eine App sehen kann, sodass Methoden wie queryIntentActivities(), getPackageInfo() und getInstalledApplications() standardmäßig kein vollständiges Geräteverzeichnis mehr zurückgeben. Weite Sichtbarkeit – im Grunde alle installierten Pakete sehen – ist die Berechtigung QUERY_ALL_PACKAGES, und Google Play schränkt sie streng ein. Verwenden Sie sie nur, wenn die Kenntnis von oder die Interoperabilität mit allen Apps auf dem Gerät für eine nutzerseitige Kernfunktion erforderlich ist. Bevorzugen Sie begrenzte, gezielte Abfragen, wann immer das Produkt ohne ein vollständiges Inventar funktionieren kann. Primärquelle: Play Console Help, „Permissions and APIs that Access Sensitive Information“, Abschnitt Package (App) Visibility Permission (https://support.google.com/googleplay/android-developer/answer/16558241). Verwandter Artikel zu zulässigen Verwendungen: „Use of the broad package (App) visibility (QUERY_ALL_PACKAGES) permission“ (https://support.google.com/googleplay/android-developer/answer/10158779).

2. QUERY_ALL_PACKAGES wird nur wirksam, wenn die App auf Android 11+ auf API 30 oder höher abzielt. Play definiert Kernfunktionalität als den Hauptzweck der App: Ohne die Fähigkeit, nach allen Apps auf dem Gerät zu suchen, ist die App „kaputt" oder unbrauchbar, und dieser Zweck samt seiner Kernfunktionen muss im Store-Eintrag deutlich dokumentiert sein. Die zulässigen Verwendungen laut Help sind Produkte, deren Aufgabe es ist, alle installierten Apps zur Kenntnisnahme oder Interoperabilität zu entdecken – Gerätesuche, Antivirus, Dateimanager und Browser. Eine Verknüpfung zu einer einzelnen App, ein Share-to-one-Messenger-Flow oder eine Schaltfläche „In Chrome öffnen" reichen nicht aus. Help listet außerdem eng begrenzte vorübergehende Ausnahmen auf (bestimmte Echtgeld-Glücksspiel-Apps, die für vorgeschriebenes Geofencing eine breite Sichtbarkeit benötigen, und dedizierte Banking- oder Digital-Wallet-Apps ausschließlich aus Sicherheitsgründen). Die Verwendung für Privatkredite, Kredite oder Kreditvermittlung ist für diese Ausnahme ausdrücklich nicht zulässig.

3. Standardmäßig eingeschränkte, gezielte Paketsichtbarkeit. Deklarieren Sie ab Android 11+ die konkreten Pakete, Intents oder Provider, die Sie benötigen, mit dem Manifest-Element <queries> statt mit QUERY_ALL_PACKAGES. Eingeschränkte Sichtbarkeit ist der richtlinienkonforme Weg: Fragen Sie nur die Apps ab, die Ihr Produkt tatsächlich startet, durchsucht oder verwaltet. Sie dürfen QUERY_ALL_PACKAGES nicht verwenden, wenn eine gezieltere, eingegrenzte Deklaration der Paketsichtbarkeit ausreicht. Plattformdokumentation: Android Developers, „Package visibility filtering on Android" (https://developer.android.com/training/package-visibility). Wenn <queries> die Interaktion abdeckt, fordern Sie QUERY_ALL_PACKAGES nicht an.

4. Alternative Methoden, die eine Sichtbarkeit auf QUERY_ALL_PACKAGES-Niveau annähern, sind genauso eingeschränkt wie die Berechtigung selbst. Die Richtlinie erlaubt solche Workarounds nur für nutzerseitige Kernfunktionen und für die Interoperabilität mit so entdeckten Apps – und die „Don'ts" zur Paket-(App-)Sichtbarkeit besagen, dass keine breite Sichtbarkeit über Methoden erlangt werden darf, die Play nicht ausdrücklich erlaubt hat. Betrachten Sie undokumentierte APIs, Accessibility-Scraping, Dateisystem-Durchläufe oder andere Sidecar-Tricks, die ein vollständiges Inventar wiederherstellen, als Richtlinienproblem und nicht als Ausweichlösung. Wenn Prüfer jedes Paket ohne genehmigte QUERY_ALL_PACKAGES-Deklaration sehen können, rechnen Sie mit einer Ablehnung oder Entfernung.

5. Wenn das Produkt QUERY_ALL_PACKAGES wirklich benötigt, reichen Sie das Permissions Declaration Form in der Play Console ein, bevor Sie veröffentlichen (Richtlinien → App-Inhalte → Berechtigungen und APIs oder die Erklärung zu Hochrisiko-/sensiblen Berechtigungen, die Play anzeigt, wenn die Berechtigung im Manifest steht). Deklarieren Sie QUERY_ALL_PACKAGES und alle weiteren Hochrisiko-Berechtigungen. Für die Prüfung dokumentieren Sie, warum die Kenntnis aller Apps für die Kernfunktion erforderlich ist, warum <queries> nicht ausreicht und wie die Inventardaten verwendet werden. Ändern Sie die Verwendung der Berechtigung, aktualisieren Sie die Erklärung mit aktuellen, korrekten Angaben. Apps, die die Berechtigung im Manifest behalten, ohne ein korrektes Formular einzureichen, oder die den Anwendungsfall-Test nicht bestehen, können entfernt werden. Täuschende oder nicht deklarierte Nutzung kann zur Sperrung der App oder zur Kontokündigung des Entwicklerkontos führen.

6. App-Inventardaten, die aus über Play vertriebenen Apps abgefragt werden, dürfen niemals für Analysen oder Werbe-Monetarisierung verkauft oder geteilt werden. Dieses Verbot hängt nicht von Einwilligungstexten ab. Senden Sie Paketlisten nicht an Werbenetzwerke, Attribution-Anbieter oder Device-Graph-Partner. Greifen Sie nur auf die Mindestdaten zu, die die Kernfunktion benötigt, halten Sie sie nach Möglichkeit auf dem Gerät und behandeln Sie die Liste als personenbezogene und sensible Informationen – auch Apps mit erlaubter QUERY_ALL_PACKAGES-Berechtigung unterliegen der Richtlinie für Nutzerdaten, einschließlich prominenter Offenlegung und Einwilligung. Unzulässige Verwendungen laut Hilfe sind unter anderem: Die Berechtigung ist nicht an den Kernzweck gebunden (P2P-Freigabe qualifiziert nur, wenn P2P der Kernzweck ist); Daten, die zum Verkauf beschafft werden; Inventar, das für Analysen oder Werbe-Monetarisierung genutzt wird; und jede Aufgabe, die eine weniger breite Sichtbarkeitsmethode erledigen kann.

7. Häufige Ablehnungen und die üblichen Korrekturen: (a) QUERY_ALL_PACKAGES im Manifest für eine Funktion, die <queries> ausdrücken kann – entfernen Sie die Berechtigung und deklarieren Sie die konkreten Pakete oder Intents; (b) Erklärung fehlt, ist veraltet oder beschreibt einen anderen Verwendungszweck als der Code – aktualisieren Sie Richtlinie → App-Inhalte und reichen Sie erneut ein; (c) der Store-Eintrag beschreibt ein Utility mit einem einzigen Zweck, während das Binary jedes Paket auflistet – entweder der Eintrag oder die Berechtigung ist falsch; (d) ein SDK fügt still und leise QUERY_ALL_PACKAGES hinzu (Security-, Fraud- oder „App-Discovery"-Kits) – entfernen oder ersetzen Sie das SDK; (e) Inventar wird an Analytics oder Werbung weitergeleitet – stoppen Sie den Export; (f) ein Workaround, der umfassende Sichtbarkeit ohne die Berechtigung nachbildet – entfernen Sie ihn; (g) eine App für Privatkredite oder Kredite, die sich auf die Ausnahme für Finanzsicherheit beruft – diese Ausnahme greift nicht.

8. Compliance-Checkliste vor dem Upload: Bestätigen Sie die Filterung auf Android 11+ / Ziel-API 30+ auf einem echten Gerät oder Emulator; bevorzugen Sie <queries> und testen Sie mit aktivierter Paket-Sichtbarkeitsfilterung; fordern Sie QUERY_ALL_PACKAGES nur an, wenn der zentrale, nutzerseitige Zweck die Kenntnis aller Apps erfordert; füllen Sie die Erklärung in der Play Console aus und halten Sie sie mit dem Artefakt synchron; verkaufen oder teilen Sie niemals Inventar für Analysen oder Anzeigen; liefern Sie keine alternativen Tricks für breite Sichtbarkeit aus; lesen Sie den Abschnitt zur Paket-(App-)Sichtbarkeit von https://support.google.com/googleplay/android-developer/answer/16558241 und den Artikel zu zulässigen Verwendungen https://support.google.com/googleplay/android-developer/answer/10158779 nach jeder SDK- oder Funktionsänderung erneut.