KappS Base de conocimiento · Preguntas frecuentes

Visibilidad de paquetes y política de QUERY_ALL_PACKAGES

Preguntas frecuentes Permisos y API

1. El inventario de apps instaladas son datos personales y sensibles del usuario. Desde Android 11 (API 30), la plataforma filtra qué otros paquetes puede ver una app, por lo que métodos como queryIntentActivities(), getPackageInfo() y getInstalledApplications() ya no devuelven por defecto un catálogo completo del dispositivo. La visibilidad amplia —ver esencialmente cualquier paquete instalado— es el permiso QUERY_ALL_PACKAGES, y Google Play lo limita estrictamente. Úsalo solo cuando el conocimiento de, o la interoperabilidad con, cualquier app del dispositivo sea necesario para una función principal orientada al usuario. Prioriza consultas acotadas y específicas siempre que el producto pueda funcionar sin un inventario completo. Fuente principal: Play Console Help, «Permissions and APIs that Access Sensitive Information», sección Package (App) Visibility Permission (https://support.google.com/googleplay/android-developer/answer/16558241). Artículo relacionado sobre usos permitidos: «Use of the broad package (App) visibility (QUERY_ALL_PACKAGES) permission» (https://support.google.com/googleplay/android-developer/answer/10158779).

2. QUERY_ALL_PACKAGES solo surte efecto cuando la app tiene como objetivo el nivel de API 30 o superior en Android 11+. Play define la funcionalidad principal como el propósito principal de la app: sin la capacidad de buscar todas las apps del dispositivo, la app está "rota" o es inutilizable, y ese propósito junto con sus funciones principales debe documentarse de forma destacada en la ficha de la tienda. Los usos permitidos según la Ayuda son productos cuya función es descubrir todas y cada una de las apps instaladas para conocimiento o interoperabilidad: búsqueda en el dispositivo, antivirus, gestores de archivos y navegadores. Un acceso directo a una sola app, un flujo de compartir con un solo mensajero o un botón de "abrir en Chrome" no bastan. La Ayuda también enumera excepciones temporales y limitadas (ciertas apps de apuestas con dinero real que necesitan amplia visibilidad para el geofencing exigido, y apps dedicadas de banca o monedero digital únicamente por seguridad). El uso para préstamos personales, crédito o facilitación de préstamos no es elegible explícitamente para esa excepción.

3. Da prioridad a una visibilidad de paquetes limitada y específica. En Android 11 o superior, declara los paquetes, intents o proveedores concretos que necesitas con el elemento <queries> del manifiesto en lugar de QUERY_ALL_PACKAGES. La visibilidad limitada es la vía preferida por las políticas: consulta solo las apps que tu producto realmente abre, busca o gestiona. No puedes usar QUERY_ALL_PACKAGES si basta con una declaración de visibilidad de paquetes más específica y acotada. Documentación de la plataforma: Android Developers, "Package visibility filtering on Android" (https://developer.android.com/training/package-visibility). Si <queries> cubre la interacción, no solicites QUERY_ALL_PACKAGES.

4. Los métodos alternativos que se aproximan a la visibilidad de QUERY_ALL_PACKAGES están restringidos igual que el propio permiso. La política solo permite esos rodeos para funcionalidades principales de cara al usuario y para la interoperabilidad con apps descubiertas de ese modo, y la lista de «lo que no se debe hacer» con la visibilidad de paquetes (apps) indica que no se debe obtener visibilidad amplia mediante métodos que Play no haya permitido explícitamente. Trata las API no documentadas, el scraping de accesibilidad, el recorrido del sistema de archivos u otros trucos auxiliares que reconstruyan un inventario completo como un problema de políticas, no como un recurso alternativo. Si los revisores pueden ver todos los paquetes sin una declaración de QUERY_ALL_PACKAGES aprobada, espera un rechazo o una retirada.

5. Si el producto realmente necesita QUERY_ALL_PACKAGES, envía el Formulario de declaración de permisos en Play Console antes de publicar (Política → Contenido de la app → Permisos y API, o la declaración de permisos de alto riesgo o sensibles que Play muestra cuando el permiso está en el manifiesto). Declara QUERY_ALL_PACKAGES y cualquier otro permiso de alto riesgo. Para la revisión, documenta por qué el conocimiento de todas y cada una de las apps es necesario para la función principal, por qué <queries> no basta y cómo se usan los datos de inventario. Si cambias el uso del permiso, actualiza la declaración con información actual y precisa. Las apps que mantienen el permiso en el manifiesto sin un formulario preciso, o que no superan la prueba de caso de uso, pueden ser retiradas. El uso engañoso o no declarado puede suspender la app o cerrar la cuenta de desarrollador.

6. Los datos de inventario de apps consultados desde apps distribuidas por Play nunca pueden venderse ni compartirse para analítica o monetización con anuncios. Esa prohibición no depende del texto de consentimiento. No envíes listas de paquetes a redes publicitarias, proveedores de atribución ni socios de gráficos de dispositivos. Accede solo a los datos mínimos que necesita la función principal, mantenlos en el dispositivo cuando puedas y trata la lista como información personal y sensible: las apps con permiso QUERY_ALL_PACKAGES siguen sujetas a la política de datos de usuario, incluidos el aviso destacado y el consentimiento. Entre los usos no válidos que recoge la Ayuda están: que el permiso no esté vinculado al propósito principal (el uso compartido P2P solo cumple si el P2P es el propósito principal); los datos obtenidos para su venta; el inventario usado para analítica o monetización con anuncios; y cualquier tarea que pueda realizar un método de visibilidad menos amplio.

7. Rechazos habituales y sus soluciones más frecuentes: (a) QUERY_ALL_PACKAGES en el manifiesto para una función que <queries> puede expresar: elimina el permiso y declara los paquetes o intents concretos; (b) declaración ausente, desactualizada o que describe un uso distinto del que hace el código: actualiza Política → Contenido de la app y vuelve a enviar; (c) la ficha de la tienda describe una utilidad de propósito único mientras el binario enumera todos los paquetes: o la ficha o el permiso están mal; (d) un SDK añade QUERY_ALL_PACKAGES de forma silenciosa (kits de seguridad, antifraude o "descubrimiento de apps"): elimina o sustituye el SDK; (e) inventario reenviado a analítica o publicidad: detén la exportación; (f) un rodeo que aproxima una visibilidad amplia sin el permiso: elimínalo; (g) una app de préstamos personales o crédito que se apoya en la excepción de seguridad financiera: esa excepción no se aplica.

8. Lista de verificación de cumplimiento antes de subir: confirma el filtrado de Android 11+ / API objetivo 30+ en un dispositivo real o emulador; prioriza <queries> y prueba con el filtrado de visibilidad de paquetes activado; solicita QUERY_ALL_PACKAGES solo cuando el propósito principal y visible para el usuario requiera conocer cualquier app y todas las apps; completa la declaración en Play Console y mantenla sincronizada con el artefacto; nunca vendas ni compartas inventario para analítica o anuncios; no incluyas trucos alternativos de visibilidad amplia; vuelve a leer la sección de visibilidad de paquetes (apps) de https://support.google.com/googleplay/android-developer/answer/16558241 y el artículo de usos permitidos https://support.google.com/googleplay/android-developer/answer/10158779 después de cualquier cambio de SDK o funcionalidad.