Cómo registrar nombres de paquetes de Android

El proceso de registro varía según si el nombre del paquete es nuevo o ya existe (tiene instalaciones).

Paso 1: Proporciona detalles del nombre de paquete (son los mismos para los nombres de paquetes nuevos y existentes)

1. Navega a la página Verificación de desarrolladores de Android.
2. Selecciona Registrar nombre de paquete en la pestaña Nombres de los paquetes.
3. Ingresa el nombre del paquete que deseas registrar.
4. Proporciona un nombre descriptivo para facilitar la identificación en Play Console.
5. Selecciona Siguiente para continuar.

Paso 2: Registra la clave

El siguiente paso depende de si registras un nombre de paquete nuevo o existente.

A. Cómo registrar un nombre de paquete nuevo

En el caso de un nombre de paquete nuevo que nunca se haya visto en Android, solo deberás proporcionar el certificado de clave pública del par de claves de firma de tu app.

1. Selecciona Agregar clave.
2. Proporciona el certificado de clave pública del par de claves de firma de tu app. (Android usa esta clave de firma para verificar que las actualizaciones de la app provengan de ti). Obtén más información para encontrar tu certificado público SHA-256.
3. Ingresa tu clave y selecciona Agregar clave.

B. Cómo registrar un nombre de paquete existente

Para registrar un nombre de paquete existente, debes demostrar la propiedad de una clave de firma privada conocida.

1. Ve a Seleccionar clave.
2. A diferencia del registro nuevo, acá se mostrará una lista de huellas digitales de certificados públicos elegibles. Estas claves se pueden usar para hacer el registro directo.
3. Examina la lista o busca directamente la huella digital de tu certificado.
4. Selecciona tu clave (si aparece en la lista) y, luego, Agregar clave.
5. Volverás a la página de registro, en la que se confirmará que se agregó la clave.

Reglas de elegibilidad de las claves y cómo solicitar el uso de un nombre de paquete

La lista de claves aptas se determina según las reglas de elegibilidad de los nombres de paquetes diseñadas para minimizar el uso compartido del nombre del paquete (se introdujo como parte de la verificación de desarrolladores de Android).

En situaciones en las que varios desarrolladores usan el mismo nombre de paquete o este tiene varias claves de firma, la elegibilidad se determina de la siguiente manera:

Situación	Regla para el registro directo	Regla para otros desarrolladores
Titular de la mayoría de las claves	Tiene prioridad la clave que representa más del 50% de las instalaciones conocidas totales.	Todos los demás desarrolladores deben enviar una solicitud.
Más de 50 instalaciones	Si ninguna clave única tiene más del 50% de las instalaciones, todas las claves con 50 instalaciones o más serán elegibles.	Los desarrolladores con claves que tengan menos de 50 instalaciones deben enviar una solicitud.
Menos de 50 instalaciones	Si ninguna clave cumple con el umbral de 50 instalaciones, se puede usar cualquiera, por orden de llegada.	Una vez que un desarrollador se registra, los demás deben enviar una solicitud.

Si tu certificado de huella digital SHA-256 NO aparece como apto, puedes registrarte, pero el proceso requiere una solicitud a Google, la cual podría rechazarse:

1. Expande la lista de otras claves en la página.
2. Confirma que comprendes las implicaciones de solicitar el uso de un nombre de paquete de esta manera.
3. Además de completar la prueba de propiedad (consulta el paso 3), también deberás enviar una justificación para usar el nombre del paquete (por ejemplo, el hecho de que migrar usuarios interrumpiría la distribución de la app).

Paso 3: Verifica la propiedad de la clave privada (solo para paquetes existentes)

Para completar la verificación de un nombre de paquete existente, debes firmar y subir un APK con la clave privada correspondiente a la clave pública que proporcionaste.

1. Selecciona Subir APK para iniciar el recorrido de verificación de propiedad del usuario.
2. En la siguiente pantalla, se muestra el nombre del paquete, se proporciona el certificado SHA-256 público seleccionado y se ofrece orientación sobre la firma.
3. Copia tu fragmento, un identificador único vinculado a tu cuenta de desarrollador.
4. Prepara el APK: En tu IDE (con un proyecto vacío con el mismo nombre de paquete o tu app real), navega al árbol del código fuente de tu app.
5. Dentro de la carpeta de recursos, crea un archivo llamado exactamente así: adi-registration.properties.
6. Abre el archivo y pega el fragmento.
   • Revisa el proyecto de muestra en GitHub para confirmar la estructura correcta y la ubicación del fragmento para la prueba de propiedad.
7. Compilación y firma: Compila un APK de lanzamiento y fírmalo con la clave privada que corresponde a la huella digital del certificado público. La firma (a través de jarsigner o signingConfigs de Gradle) sirve como prueba de propiedad legítima.
   Nota: Registro del nombre de paquete para apps con claves de firma delegadas

   Si el nombre de paquete que registras pertenece a una app en la que la clave de firma privada se delegó a una plataforma de distribución externa, como Samsung Galaxy Store, debes seguir estos pasos para demostrar la propiedad de la clave privada.

   • Compila y sube el APK o AAB de la versión a la plataforma de distribución.
   • Descarga el APK de la versión final firmado directamente desde esa plataforma de distribución.
   • Sube el APK firmado que descargaste a Play Console en el paso 9.
8. Carga: Vuelve a Play Console, selecciona Subir, busca el APK de la versión firmado y súbelo. Android verificará la firma y registrará tu propiedad.

Paso 4: Haz un seguimiento del registro del nombre de paquete

Android intentará registrar formalmente el nombre del paquete y lo vinculará a tu identidad de desarrollador de Play verificada.

Recibirás una notificación por correo electrónico cuando se complete el proceso.
Puedes supervisar el estado del registro y de la clave en la página Paquetes.

Cómo agregar claves adicionales

Una vez que registres un nombre de paquete, podrás agregar claves adicionales.

1. Selecciona Subir APK para iniciar el recorrido de verificación de propiedad del usuario.
2. En la siguiente pantalla, se muestra el nombre del paquete, se proporciona el certificado SHA-256 público seleccionado y se ofrece orientación sobre la firma.
3. Copia tu fragmento, un identificador único vinculado a tu cuenta de desarrollador.
4. Prepara el APK: En tu IDE (con un proyecto vacío con el mismo nombre de paquete o tu app real), navega al árbol del código fuente de tu app.
5. Dentro de la carpeta de recursos, crea un archivo llamado exactamente así: adi-registration.properties.
6. Abre el archivo y pega el fragmento.
   • Revisa el proyecto de muestra en GitHub para confirmar la estructura correcta y la ubicación del fragmento para la prueba de propiedad.
7. Compilación y firma: Compila un APK de lanzamiento y fírmalo con la clave privada que corresponde a la huella digital del certificado público. La firma (a través de jarsigner o signingConfigs de Gradle) sirve como prueba de propiedad legítima.
8. Carga: Vuelve a Play Console, selecciona Subir, busca el APK de la versión firmado y súbelo. Android verificará la firma y registrará tu propiedad.

Obtén ayuda

Comunícate con nosotros para obtener ayuda con la verificación de desarrolladores de Android en Play Console.