Credenciales e Implementación de iOS

Certificados, perfiles y credenciales administradas por EAS - el manual para firma de iOS en Expo SDK 57 sin que cada ingeniero mantenga carpetas de firma de Xcode.

Receta

Tarjeta de receta de referencia rápida - lista para copiar y pegar.

# Configuración interactiva de credenciales
eas credentials --platform ios
 
# Primera compilación de producción (solicita inicio de sesión en Apple)
eas build --profile production --platform ios
 
# Compilación de CI no interactiva después de que existan credenciales
eas build --profile production --platform ios --non-interactive

// app.config.ts - el ID del bundle es el ancla de firma
import type { ExpoConfig } from "expo/config";
 
const config: ExpoConfig = {
  name: "ShopApp",
  slug: "shop-app",
  ios: {
    bundleIdentifier: "com.example.shopapp",
    buildNumber: "1",
  },
  extra: {
    eas: { projectId: "00000000-0000-0000-0000-000000000000" },
  },
};
 
export default config;

// eas.json - la distribución store vs internal afecta el tipo de perfil
{
  "build": {
    "production": {
      "distribution": "store",
      "ios": { "simulator": false }
    },
    "preview": {
      "distribution": "internal",
      "ios": { "simulator": false }
    }
  }
}

Cuándo usarlo:

• El primer eas build --platform ios pregunta sobre certificados y perfiles de implementación.
• Xcode reporta "No profiles for bundle identifier" en la máquina de un compañero.
• Reemplazar a un ingeniero que era el único administrador del portal de Apple Developer.
• Agregar push, Sign in with Apple o dominios asociados antes de QA en TestFlight.

Ejemplo Funcional

Paso 1 - Registra el identificador del bundle

1. Apple Developer → Certificates, Identifiers & Profiles → Identifiers.
2. Crea App ID que coincida con ios.bundleIdentifier en app.config.ts.
3. Habilita las capacidades que necesites (Push, Associated Domains, etc.) - ver Entitlements & Capabilities.

Paso 2 - Deja que EAS administre las credenciales de firma

eas credentials --platform ios

Elige para una app nueva:

? What do you want to do? › Set up credentials for a new bundle identifier
? Generate a new Apple Distribution Certificate? › Yes
? Generate a new Apple Provisioning Profile? › Yes

EAS almacena:

• Apple Distribution Certificate (equivalente a .p12, encriptado en servidores de Expo)
• Provisioning Profile (App Store o Ad Hoc dependiendo de distribution)
• Push Notification Key opcional (.p8) para APNs

Paso 3 - Registra dispositivos para compilaciones internas

# Crea un enlace de registro para probadores
eas device:create
 
# Lista dispositivos registrados
eas device:list

Los perfiles internos ("distribution": "internal") incorporan UDIDs registrados. Los probadores deben registrarse antes de que reconstruyas.

Paso 4 - Compila y verifica

eas build --profile production --platform ios
eas build --profile preview --platform ios   # ad hoc / probadores internos

Descarga el IPA e instala a través de TestFlight (eas submit) o enlace ad hoc - Internal Distribution.

Tipos de Credenciales

Operaciones Comunes

Rota un certificado de distribución comprometido

eas credentials --platform ios
# Elige: Remove distribution certificate → Generate new → Rebuild all profiles
eas build --profile production --platform ios --clear-cache

• Apple permite dos certificados de distribución activos - planifica la rotación antes de que expire
• Todos los IPAs firmados con el certificado anterior permanecen válidos hasta que expiren los perfiles
• Notifica al equipo - las compilaciones de CI --non-interactive recogen nuevas credenciales automáticamente

Carga credenciales existentes (migración brownfield)

eas credentials --platform ios
# Elige: Upload distribution certificate (.p12 + password)
# Elige: Upload provisioning profile (.mobileprovision)

• Coincide bundle ID, team ID y capabilities exactamente con tu app existente
• Revoca certificados duplicados en el portal de Apple después de confirmar que las compilaciones de EAS tienen éxito
• Empareja con Migrating Manual Native Projects to CNG cuando migres de proyectos Xcode editados manualmente

Sincroniza capacidades desde app.config

EAS puede habilitar capacidades del portal que coincidan con tus plugins de configuración:

{
  "build": {
    "production": {
      "ios": {
        "autoIncrement": true
      }
    }
  }
}

// app.config.ts - los dominios asociados requieren alineación del portal + entitlements
ios: {
  associatedDomains: ["applinks:shop.example.com"],
},
plugins: [["expo-notifications", { icon: "./assets/notification-icon.png" }]],

• Las discrepancias de capacidades se presentan como provisioning profile doesn't include entitlement errores
• Primero, corrige en app.config.ts / plugins - luego regenera perfiles a través de eas credentials

Solución de Problemas

Preguntas Frecuentes

Relacionado

• EAS Build Basics - primera compilación de iOS en la nube
• Internal Distribution - rutas ad hoc y TestFlight
• EAS Submit - sube a App Store Connect
• ../ios-platform/entitlements-and-capabilities/entitlements-and-capabilities.md - push, dominios asociados, modos de fondo
• ../ios-platform/testflight-distribution/testflight-distribution.md - grupos de probadores internos/externos
• ../ios-platform/ios-basics-for-rn-devs/ios-basics-for-rn-devs.md - vocabulario de firma de Xcode
• ../cng-prebuild/prebuild-basics/prebuild-basics.md - flujos de ID de bundle en proyecto Xcode generado
• ../expo-rules/release-and-ota-rules/release-and-ota-rules.md - compilaciones de store vs elegibilidad de OTA

Stack versions: Esta página fue escrita para React 19.2.3, React Native 0.86.0 y Expo SDK 57 (expo ~57.0.4).