Publicar en la Chrome Web Store: el proceso completo de registro, empaquetado y envío a revisión
Objetivo en una frase: publicar la extensión local que lograste ejecutar en la lección anterior, completando los tres pasos de la publicación de un complemento de Chrome: «registrar cuenta de desarrollador → empaquetar y subir → enviar a revisión», para entrar en la cola de revisión de la Chrome Web Store y que usuarios desconocidos puedan buscar e instalar tu complemento.
Qué podrás hacer al terminar
- Registrar una cuenta de desarrollador de Chrome Web Store y poder entrar en la consola de desarrolladores
- Empaquetar el directorio de la extensión en un zip válido con manifest.json en el directorio raíz
- Rellenar en la consola la información del producto de 5 pestañas
- Pulsar Submit for Review para que la extensión entre en la cola de revisión de la tienda
Tu situación actual
- «El complemento ya funciona, pero solo vive en mi propio navegador. Si un amigo lo quiere, solo puedo explicarle por control remoto cómo activar el modo de desarrollador y cargar la carpeta manualmente.»
- «He oído que publicar cuesta dinero y requiere revisión, pero no tengo ni idea de en cuántos pasos se divide ni qué materiales hay que preparar en cada uno.»
- «Lo que más temo es rellenar mal la información: si escribo mal el correo de la cuenta, ¿queda inservible?»
Cuándo usar esta técnica
Cuando necesitas: distribuir la extensión a desconocidos; cualquiera podrá buscar tu complemento en la Chrome Web Store e instalarlo con un clic, sin que tengas que enviar archivos uno por uno.
Y no quieres: explicar por control remoto a un amigo cómo activar el modo de desarrollador y cargar manualmente la carpeta; o que el complemento quede instalado solo en tu propia computadora para siempre.
🎒 Preparativos antes de empezar
- Haber completado la lección previa《El primer complemento de Chrome: Hello World funcionando en 15 minutos》, con la extensión cargándose correctamente en el navegador y todas las funciones operativas; la documentación oficial también recomienda probar las funciones en local antes de subir.
- Una cuenta de Google elegida con cuidado antes de usarla: el correo vinculado a la cuenta de desarrollador no se puede cambiar una vez creada. La recomendación oficial es abrir un correo nuevo específico para publicar, y que sea uno que consultes con frecuencia: las notificaciones importantes, como retiros de la tienda o rechazos, se envían por correo de forma predeterminada.
- Tener presupuestada la tarifa de registro única; el importe se rige por la página de pago real de la consola de desarrolladores@@I18N_KEEP_000007@@.
- Tener listos los materiales de la extensión: manifest.json, iconos, capturas de pantalla y textos de descripción; las 5 pestañas tienen bastantes campos obligatorios, y hacerlos sobre la marcha interrumpe el flujo.
- Confirmar el alcance: este tutorial solo cubre extensiones Manifest V3 de la Chrome Web Store; publicar en Firefox o Edge queda fuera de esta ruta.
Idea central
La esencia de publicar un complemento de Chrome es convertir «una carpeta en tu computadora» en «un producto en la tienda». Cada uno de los tres pasos se encarga de una cosa:
| Etapa | Lo que debes hacer | Resultado | Dónde es más fácil equivocarse |
|---|---|---|---|
| ① Registro | Pagar la tarifa de registro única y obtener la cuenta de desarrollador | Una cuenta capaz de publicar productos | El correo no se puede cambiar una vez creado |
| ② Empaquetado | Revisar el manifest y comprimirlo en un zip válido | Un zip con el manifest en el directorio raíz | El zip lleva una carpeta de más envolviendo el contenido |
| ③ Envío a revisión | Subir el zip, rellenar 5 pestañas y enviar | El producto entra en la cola de revisión | Pulsar enviar sin completar los campos obligatorios |
Los tres pasos son secuenciales: la cuenta es el pase de entrada, el zip es el cuerpo del producto y la información del producto es la exhibición en el escaparate. El revisor recibe la combinación de estas tres cosas; un error en cualquier eslabón hará que te lo devuelvan para rehacerlo.
Hazlo conmigo
Paso 1: registrar una cuenta de desarrollador (primer paso de la publicación de un complemento de Chrome)
Por qué: sin una cuenta de desarrollador, la consola de desarrolladores ni siquiera te mostrará la entrada de «Añadir artículo nuevo»: consigue primero este pase de entrada, para que los dos pasos siguientes tengan dónde apoyarse.
Abre la consola de desarrolladores de Chrome Web Store (chrome.google.com/webstore/devconsole) e inicia sesión con tu cuenta de Google. La primera vez aparecerá la página de registro: primero acepta el acuerdo y las políticas para desarrolladores, luego paga la tarifa de registro única@@I18N_KEEP_000008@@. Al registrarte debes proporcionar un correo de desarrollador; China (China) figura en la lista de países/regiones que admiten el registro.
Deberías ver: tras completar el pago, al volver a entrar en la consola la página de registro ya no aparece; podrás ver la lista de productos y el botón «Añadir artículo nuevo (Add new item)».
- La página de registro ya no aparece y en la consola se ve la entrada de «Añadir artículo nuevo»
Paso 2: revisar el manifest y empaquetarlo en zip (empaquetar el complemento en zip)
Por qué: una vez subida la extensión, ya no podrás cambiar los metadatos del manifest en la consola de desarrolladores; aunque sea un error tipográfico, tendrás que modificar el archivo, subir el número de versión y volver a empaquetar. Así que revisa el manifest antes de empaquetar.
Revisa cuatro cosas en orden:
- Los cuatro campos
name,version,icons,descriptionestán completos;namese mostrará en la tienda y en el navegador, ydescriptionno puede superar los 132 caracteres. - Ponle a
versionun valor bajo, como0.0.0.1: la tienda exige que cada versión nueva subida tenga un número mayor que la anterior, y empezar con un valor bajo deja margen para incrementos. - El manifest no puede contener comentarios: los comentarios son una causa habitual del error «Cannot parse the manifest» al subir.
- Al comprimir, selecciona los archivos de** dentro** del directorio de la extensión y comprime; manifest.json debe quedar en el directorio raíz del zip y no dentro de una subcarpeta. El límite de tamaño del paquete es 2 GB; un complemento normal está muy lejos de alcanzarlo.
Deberías ver: al descomprimir el zip en un directorio temporal, ves manifest.json directamente en el primer nivel.
- Descomprime el zip: en el primer nivel está manifest.json
Paso 3: subir el zip, rellenar la información del producto y enviarlo a revisión (envío a revisión del complemento)
Por qué: el zip es solo el cuerpo del producto; la tienda también exige que completes la «información de escaparate»: los usuarios se basan en ella para decidir si instalar, y los revisores para entender qué hace tu complemento.
- En la consola de desarrolladores, pulsa Add new item, selecciona Choose file para elegir el zip recién creado y pulsa Upload. Si el zip y el manifest son válidos, entrarás en la página de edición del producto.
- Rellena una a una las 5 pestañas del menú lateral:
- Package: información del paquete subido; esta página no es editable en la primera creación;
- Store Listing: detalles del producto, determina cómo se muestra la página de la tienda;
- Privacy: declara el propósito único de la extensión y cómo maneja los datos del usuario;
- Distribution: si es de pago, en qué países se publica y para qué usuarios es visible;
- Test instructions: instrucciones de prueba y credenciales para los revisores; rellenar solo cuando sea necesario.
- Una vez completados todos los campos obligatorios, haz clic en Submit for Review y vuelve a confirmar en la ventana emergente de confirmación.
Deberías ver: el estado del producto cambia a «En revisión» y tu extensión aparece en la lista de productos del panel.
- Campos obligatorios de 5 pestañas completados, el estado ya cambió a «En revisión»
💡 ¿Quieres controlar tú mismo el momento de publicación?
En la ventana emergente de confirmación de envío puedes controlar el momento de publicación: desmarca esa opción y, al completarse la revisión, el producto no se publicará automáticamente de inmediato; podrás publicarlo manualmente cuando elijas. Cuándo publicar y cómo hacer rollback se explica en detalle en la próxima lección.
⚠️ Los nuevos publicadores tienen un límite de cantidad
Al crear una cuenta de publicador por primera vez, solo puedes tener como máximo 2 extensiones publicadas (contando las que están en la tienda; los temas no ocupan cupo). El límite actual es visible en el panel de desarrolladores; al alcanzarlo puedes solicitar un aumento, y en la mayoría de los casos el resultado es inmediato. Pulir bien una extensión primero es mejor que subir un montón de golpe.
Punto de control ✅
- La página de registro ya no aparece y en el panel de desarrolladores se ve la entrada «Add new item» (añadir nuevo artículo)
- Al descomprimir el zip, manifest.json está en el primer nivel y el manifest no tiene comentarios
- Los cuatro campos del manifest están completos, description ≤ 132 caracteres, version empieza desde un valor bajo como 0.0.0.1
- Campos obligatorios de las 5 pestañas completados, ya se hizo clic en Submit for Review
- El estado del producto en el panel muestra «En revisión» y el correo de registro es uno que revisas con frecuencia
Avisos de errores comunes
❌ El zip tiene una carpeta de más
Al comprimir, se arrastró la carpeta completa del proyecto y manifest.json quedó comprimido en un subdirectorio.
Causa: la tienda exige que el manifest esté en la raíz del zip; una capa de más hace que falle directamente.
Solución correcta: selecciona los archivos de dentro del directorio de la extensión antes de comprimir; antes de enviar, descomprime el zip una vez y confirma que en el primer nivel esté manifest.json.
❌ Se dejaron comentarios en el manifest
Al subir aparece «Cannot parse the manifest».
Causa: el manifest es un archivo JSON, y dejar comentarios es una causa frecuente de este error de análisis.
Solución correcta: elimina todos los comentarios del manifest y vuelve a empaquetar y subir.
❌ Se puso un correo cualquiera que casi no se revisa
Causa: el correo de la cuenta de desarrollador no se puede cambiar después de crearla; para cambiarlo hay que crear una cuenta nueva y luego transferir los productos mediante el formulario oficial; las notificaciones importantes como retiros de la tienda o rechazos se envían por defecto a este correo, y pasarlas por alto puede causar problemas.
Solución correcta: piénsalo bien antes de registrarte. La recomendación oficial es abrir un correo nuevo específicamente para publicar y asegurarte de que sea uno que revises con frecuencia.
❌ El número de versión se puso muy alto desde el principio
Causa: la tienda exige que cada número de versión nuevo sea mayor que el anterior; además, tras la subida los metadatos del manifest no se pueden cambiar en el panel, así que corregir una simple errata requiere subir el número de versión y volver a empaquetar. Si empiezas con un número muy alto, luego no hay margen para crecer.
Solución correcta: asigna un valor bajo al primer número de versión, como 0.0.0.1.
Resumen de la lección
Publicar una extensión de Chrome son solo 3 pasos: registrar una cuenta de desarrollador → empaquetar el zip → enviar a revisión.
- ✅ Registro: tarifa de registro única (el importe se rige por la página de pago real), el correo no se puede cambiar después de crearlo
- ✅ Empaquetado: los cuatro campos del manifest completos y sin comentarios, manifest.json en la raíz del zip, tamaño del paquete ≤ 2GB
- ✅ Envío a revisión: sube el zip en Add new item, completa las 5 pestañas y haz clic en Submit for Review
- ✅ Los nuevos publicadores tienen como máximo 2 extensiones publicadas; concéntrate primero en pulir una
Repaso de los campos de configuración clave:
| Campo | Valor recomendado | Explicación |
|---|---|---|
manifest.json de version | 0.0.0.1 un valor bajo como este | Cada nuevo número de versión debe ser mayor que el anterior; empezar con un valor bajo deja margen para incrementos |
description de manifest.json | ≤ 132 caracteres | Se usa en la página de detalles de la tienda, límite de 132 caracteres |
name, icons de manifest.json | Definir con antelación | Tras la subida, los metadatos del manifest no se pueden cambiar en el panel |
| Estructura del zip | manifest.json en la raíz | Una carpeta de más hace que falle |
| Tamaño del paquete | ≤ 2GB | Si se supera, será rechazado |
Avance de la próxima lección
El envío es solo el comienzo: ¿cuánto tarda la revisión, cómo aumentar la tasa de aprobación y qué hacer si te rechazan? Sigue aprendiendo en «Estrategia de revisión y publicación en la tienda: revisión en 3 días, lanzamiento gradual y rollback».
Aprenderás:
- El proceso de revisión de la tienda y su duración aproximada
- Qué preparativos puedes hacer para aumentar la tasa de aprobación
- Correcciones y reenvío tras un rechazo
- Cómo hacer un lanzamiento gradual y un rollback
Si sigues la ruta del mini programa de WeChat, puedes consultar «Envío a revisión y publicación: guía para evitar errores en las reglas de revisión de WeChat».