Resumen
Elige las claves de firma Android correctas, registra certificados SHA-256 adicionales y resuelve mensajes de elegibilidad o huellas distintas sin exponer claves privadas.
Para quién: Responsables de lanzamiento que ven mensajes sobre claves aptas, claves adicionales o huellas distintas al registrar un paquete existente.
Secuencia de lanzamiento
- Haz un inventario del artefacto que recibe el usuario en cada canal activo.
- Extrae el SHA-256 público y etiqueta la clave como firma de la app, subida/carga, antigua o propia del canal.
- Selecciona una clave apta o usa la revisión oficial y añade cada clave legítima que firme una versión distribuida.
- Completa la prueba de propiedad y vuelve a consultar la pareja paquete-certificado exacta.
Datos clave
No rotes una clave de producción porque no figure en una lista de aptas. Confirma el artefacto y la función de la clave, conserva la continuidad de actualizaciones y usa la solicitud o revisión oficial.
Guía detallada
Registra el certificado que firma la app instalada
Empieza por el artefacto que instala el usuario. Con la firma de apps de Play, Google firma los APK entregados con la clave de firma de la aplicación; tu clave de subida, también llamada clave de carga en la ayuda latinoamericana, solo autentica los envíos. Otra tienda o una build web puede usar un certificado distinto.
Extrae el SHA-256 de cada APK distribuido e indica el canal. Registrar un alias de almacén conocido no sirve si esa clave no firma la app instalada.
- APK entregado por Play: certificado de firma de la aplicación.
- Subida a Play: certificado de subida o carga con otra función.
- Otro canal: inspecciona el APK de producción de ese canal.
apksigner verify --print-certs app-release.apkElige la clave apta o solicita revisión
Para un paquete existente, la consola puede mostrar claves asociadas a su historial. Elige la que corresponda a la versión que reciben los usuarios. Si la clave de producción correcta no aparece como apta, comprueba que no sea una clave de subida o depuración y usa la solicitud o revisión de la consola explicando el historial de distribución.
Para un paquete nuevo, sigue el flujo vigente y guarda paquete, certificado y cuenta en el mismo registro de release. No generes otra clave solo para que aparezca en la lista.
- Comparar huellas SHA-256, no alias.
- Guardar pruebas de versiones antiguas y canales.
- Conservar la clave que mantiene las actualizaciones.
Añade todas las claves de distribución legítimas
Un paquete puede tener varias claves legítimas cuando existen canales o historiales de firma aprobados. Añade cada certificado público por el flujo oficial de claves adicionales y asigna canal y responsable a cada huella.
Si la consola pide prueba de propiedad, completa el reto con la clave correspondiente. Puede implicar un APK firmado y adi-registration.properties; nunca exige subir la clave privada.
- Añadir solo claves que firmen un artefacto distribuido real.
- Mantener las claves privadas en el sistema de firma existente.
- Esperar a que termine el procesamiento antes de volver a consultar.
Separa errores de registro y errores de subida a Play
Una diferencia de registro significa que el paquete está vinculado a otra huella. Un App Bundle firmado con la clave equivocada en Play es un problema de clave de subida o firma de apps de Play. El paquete puede ser el mismo, pero las soluciones son distintas.
Usa la consulta paquete-certificado para validar el registro. Para un AAB rechazado, revisa certificados y guía de subida en Play Console. Cambiar una clave antes de identificar la capa que falla complica la recuperación.
- Registro: paquete más certificado público.
- Rechazo de AAB: certificado de subida esperado.
- Identidad instalada desde Play: certificado de firma de la aplicación.
Introduce el nombre de producción. Para comprobar la firma, añade la huella SHA-256 del certificado del APK que reciben los usuarios. El resultado no sustituye la revisión de la tienda.
Comprobar el estado →Preguntas frecuentes
¿Un paquete Android puede tener varias claves?
Sí. Se pueden registrar claves legítimas adicionales para canales reales o un historial aprobado. Asocia cada huella SHA-256 con su artefacto y canal.
¿Qué clave uso con la firma de apps de Play?
Para la identidad de la app entregada por Google Play, usa el certificado de firma de la aplicación. El certificado de subida o carga autentica el bundle y puede ser distinto.
¿Qué hago si mi clave de producción no es apta?
Confirma primero que firma el artefacto de producción instalado y que no es una clave de subida o depuración. Usa después la solicitud o revisión oficial con las pruebas requeridas.
¿Tengo que subir la clave privada?
No. El registro usa la huella del certificado público. La prueba puede requerir un APK firmado, pero la clave permanece en el almacén o servicio de firma.
¿Por qué Play dice que el App Bundle usa otra clave?
El mensaje suele referirse al certificado de subida esperado por Play, no al certificado registrado para la verificación Android. Investígalo en Play Console antes de cambiar claves.
Fuentes y revisión
Última revisión: