Soporte

¿Te has atascado en algún punto de ShouArchive? Revisa primero las preguntas de abajo y, si necesitas más ayuda, escríbenos.

Contacto beakbigkb@gmail.com Solemos responder en unos días. Los consejos para informar de un problema están al final.

Primeros pasos

La pestaña Perfiles me pide permitir una carpeta. ¿Por qué?

La edición del Mac App Store se ejecuta dentro del sandbox de macOS. Una app en sandbox solo puede leer las carpetas que hayas elegido explícitamente, y la carpeta donde Xcode guarda los perfiles de aprovisionamiento está fuera de la app, así que hay que permitirla una vez.

Haz clic en el botón de carpeta de la pestaña Perfiles. Se abre un panel con esa carpeta ya seleccionada: no cambies nada, solo pulsa Permitir. El permiso se recuerda entre ejecuciones (marcadores con ámbito de seguridad de macOS).

Carpetas que lee la app:

  • ~/Library/Developer/Xcode/UserData/Provisioning Profiles — Xcode 16 y posteriores
  • ~/Library/MobileDevice/Provisioning Profiles — versiones anteriores de Xcode

~/Library está oculta en el Finder de forma predeterminada. En el panel de apertura, pulsa ⌘⇧G y pega la ruta para ir directamente. Si prefieres no permitir la carpeta, puedes seguir arrastrando archivos .mobileprovision a la ventana o usar «Añadir desde archivo…».

¿Qué tipos de archivo se admiten?
  • Inspección de artefactos: .ipa (pestaña iOS), .apk y .aab (pestaña Android)
  • Distribución OTA: .ipa (iOS), .apk (Android). Los AAB no pueden instalarse directamente en un dispositivo, así que no se aceptan.
  • Perfiles: .mobileprovision
  • Clave de API: el archivo .p8 descargado de App Store Connect

Suelta un archivo en la ventana o usa «Elegir archivo…» (⌘O).

¿Por qué esta edición no compila ni exporta IPA/APK?

Las apps del Mac App Store deben ejecutarse en sandbox, y el sandbox no puede lanzar programas externos como xcodebuild o gradle. Por eso esta edición se centra en tres cosas: inspección, perfiles y OTA. La inspección de artefactos tampoco depende de herramientas externas: el analizador propio de la app lee los archivos IPA, APK y AAB directamente.

Perfiles y la API de App Store Connect

¿Cómo creo una clave de API de App Store Connect?
  1. Ve a App Store ConnectUsuarios y accesoIntegracionesAPI de App Store Connect.
  2. Genera una clave de equipo. Leer y crear perfiles y dispositivos suele requerir el rol de Administrador.
  3. Introduce el Issuer ID, el Key ID y el archivo .p8 descargado en «Descargar perfil» › «Clave de API» dentro de la app. Al elegir un archivo AuthKey_XXXXXXXX.p8, el Key ID se rellena automáticamente.

Apple solo permite descargar el archivo .p8 una vez, así que guárdalo en un lugar seguro. La app nunca usa tu Apple ID ni códigos de verificación en dos pasos.

¿Dónde se guarda la clave de API y adónde se envía?

El archivo .p8 se queda donde tú lo guardes; la app solo recuerda una referencia a él (un marcador con ámbito de seguridad). Los tokens de las solicitudes se firman en tu Mac y la clave en sí nunca se envía a ningún sitio: la app solo se comunica con la API de App Store Connect de Apple (api.appstoreconnect.apple.com). Quitar una clave en la app no elimina el archivo .p8.

¿Qué significan «Vence pronto» y la insignia D-N?

Un perfil que caduca en menos de 30 días aparece como «Vence pronto» y muestra los días restantes en una insignia naranja D-N. Todo lo que ya pasó su fecha entra en «Caducidad» (rojo). «Nuevo» indica que se creó hace poco; «Duplicado» marca dos o más perfiles con el mismo equipo, ID de app y tipo.

La tarjeta «Certificado» está vacía.

La lista de certificados de firma de código de tu llavero no puede leerse desde dentro del sandbox, así que esta tarjeta está vacía en la edición del Mac App Store. Los certificados incrustados en cada perfil sí se muestran en las vistas de detalle y de comparación, con botones para copiar el SHA-1 y el SHA-256.

¿Cuántos dispositivos puedo registrar?

Una cuenta de Apple Developer puede registrar hasta 100 dispositivos por tipo (iPhone, iPad, Mac, …) por año de membresía. Los dispositivos que desactives siguen ocupando plaza hasta que se renueve la membresía. La pestaña Dispositivos muestra el uso actual por tipo (por ejemplo, iPhone 3 / 100).

Inspección de artefactos

¿Inspeccionar un archivo lo modifica o lo sube a algún sitio?

No. El archivo es de solo lectura: el original nunca se modifica, no se escribe ningún archivo de resultados junto a él y no se envía nada a ningún servidor. Los resultados se muestran únicamente en la ventana de la app.

No sé qué significa un elemento.

Los nombres de elemento con subrayado punteado (permisos, funciones del dispositivo, ajustes del manifiesto, huellas de certificado, entitlements, etc.) abren un panel emergente con qué es · detalles · a qué prestar atención. Para la tarjeta de 16 KB, haz clic en la ⓘ junto al título.

¿Qué comprueba la verificación del tamaño de página de 16 KB?

A partir de Android 15, algunos dispositivos usan páginas de memoria de 16 KB y Google Play exige bibliotecas nativas compatibles con ellas. La app comprueba la alineación de los segmentos LOAD del ELF en los archivos .so de 64 bits (arm64-v8a, x86_64) y, en los .so almacenados sin comprimir dentro de un APK, su límite de 16 KB dentro del archivo, y enumera las bibliotecas que no cumplen.

Distribución OTA

Generé los archivos OTA, pero la app no se instala en el dispositivo.

Revisa estos puntos en orden:

  • El IPA, manifest.plist e install.html deben servirse por https. iOS se niega a instalar por http.
  • Abre el enlace de instalación o el código QR en Safari en el dispositivo. Las vistas previas de mensajería y los navegadores integrados en apps a menudo no inician la instalación.
  • Ad Hoc: el UDID del dispositivo debe estar en el perfil. Si no lo está, añade el dispositivo al perfil y vuelve a compilar el IPA.
  • Enterprise: tras instalar, ve a Ajustes › General › VPN y gestión de dispositivos y marca el desarrollador como de confianza.
  • Un IPA firmado con un perfil de distribución de App Store no puede instalarse por OTA. La app te avisa cuando eliges un archivo así.
  • Comprueba que la URL del IPA en el manifest coincide con la ubicación real del archivo y que el nombre del archivo no tiene espacios ni caracteres especiales.
¿Dónde se guardan los archivos generados?

«Crear archivo de instalación» (⌘↩) te pide una carpeta de salida. Allí crea una carpeta <name>_OTA y coloca en ella una copia del IPA (o APK) junto con <name>.manifest.plist, <name>.install.html y <name>.qr.png (Android: .install.html y .qr.png), sobrescribiendo los archivos con el mismo nombre. La app nunca sube nada, así que súbelos tú junto con el IPA o el APK.

¿Cómo funciona la instalación en Android?

Sube el APK, install.html y la imagen QR a la misma carpeta https y abre la página de instalación en el navegador del dispositivo (Chrome). Como la app no procede de Play Store, el dispositivo debe permitir la instalación desde orígenes desconocidos. La página muestra el SHA-256 para que los testers puedan verificar la descarga.

General

¿Cómo cambio el idioma?

Abre el menú del globo terráqueo en la barra de herramientas, elige un idioma y confirma «Reiniciar ahora». La app se vuelve a abrir en ese idioma y tu trabajo se conserva. Idiomas disponibles: Español, English, 한국어, 日本語, 简体中文 y 繁體中文.

¿Tema y tamaño del texto?

Elige Claro, Oscuro o Configuración del sistema en la barra de herramientas. El tamaño del texto va del 85 % al 150 % desde el menú Visualización (Texto más grande ⌘+, Texto más pequeño ⌘-, Predeterminado ⌘0) o en Ajustes (⌘,) › Pantalla.

Requisitos del sistema

macOS 15 Sequoia o posterior, en Mac con Apple Silicon o Intel. La clave de API de App Store Connect solo hace falta para descargar y crear perfiles y registrar dispositivos; todo lo demás funciona sin conexión.

¿Cómo informo de un problema?

Escribe a beakbigkb@gmail.com con lo siguiente y podremos revisarlo rápido:

  • Versión de macOS (menú Apple › Acerca de este Mac)
  • Versión de la app (menú ShouArchive › Acerca de ShouArchive)
  • Qué hiciste, paso a paso, y qué ocurrió
  • Una captura de pantalla o el texto exacto del error, si es posible

No hace falta adjuntar archivos IPA, APK ni perfiles. Si se necesita alguno, se te pedirá aparte; y antes de enviar nada, asegúrate de que no contiene archivos de clave (.p8) ni datos sensibles.