Perfiles de compilación y sabores

Q: ¿Pueden instalarse desarrollo y producción en el mismo teléfono?

Sí si bundleIdentifier / package difieren - usa sufijos APP_VARIANT como .dev y .staging. No si comparten el mismo ID - la nueva instalación reemplaza la aplicación antigua.

Q: ¿Cuántos perfiles deberíamos tener?

Comienza con tres: desarrollo, vista previa y producción. Agrega perfiles específicos de marca o plataforma con extends cuando sea necesario. Evita perfiles nombrados por ingeniero ("jane-debug") - usa entornos y canales en su lugar.

Q: ¿Debería la vista previa usar distribución de tienda o interna?

internal para APK/ad hoc e iteración rápida. store + TestFlight interno cuando control de calidad necesita firma idéntica a la producción - Distribución de TestFlight.

Q: ¿Cómo comparten aplicaciones de etiqueta blanca un repositorio?

Base de código única + env BRAND + credenciales separadas por nombre de paquete. Proyectos de EAS separados o aislamiento de canal estricto por marca. Documenta qué perfil mapea a cuál Play Console / aplicación de App Store Connect.

Desarrollo, vista previa, producción y variantes de etiqueta blanca - la guía para estructurar perfiles de eas.json y app.config.ts dinámico en Expo SDK 57.

Receta

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

// eas.json - línea base de tres entornos
{
  "cli": { "version": ">= 16.0.0", "appVersionSource": "remote" },
  "build": {
    "development": {
      "developmentClient": true,
      "distribution": "internal",
      "environment": "development",
      "channel": "development"
    },
    "preview": {
      "distribution": "internal",
      "environment": "preview",
      "channel": "preview"
    },
    "production": {
      "distribution": "store",
      "environment": "production",
      "channel": "production",
      "autoIncrement": true
    }
  }
}

// app.config.ts - APP_VARIANT del entorno de eas.json
import type { ExpoConfig } from "expo/config";
 
const variant = process.env.APP_VARIANT ?? "production";
 
const bundleIds: Record<string, string> = {
  development: "com.example.shopapp.dev",
  preview: "com.example.shopapp.staging",
  production: "com.example.shopapp",
};
 
const config: ExpoConfig = {
  name: variant === "production" ? "Shop" : `Shop (${variant})`,
  slug: "shop-app",
  ios: { bundleIdentifier: bundleIds[variant] },
  android: { package: bundleIds[variant] },
  extra: {
    apiUrl: process.env.EXPO_PUBLIC_API_URL,
    eas: { projectId: "00000000-0000-0000-0000-000000000000" },
  },
};
 
export default config;

// eas.json - pasar variante al prebuild
{
  "build": {
    "preview": {
      "env": { "APP_VARIANT": "preview" },
      "environment": "preview"
    }
  }
}

Cuándo usar esto:

Staging y producción deben instalarse lado a lado en el mismo dispositivo.
Las marcas de etiqueta blanca comparten una base de código con iconos e IDs de paquete diferentes.
Control de calidad necesita URLs de API de vista previa sin arriesgar datos de producción.
Los canales de EAS Update no deben contaminarse entre entornos.

Ejemplo funcional

Paso 1 - Definir responsabilidades del perfil

Perfil	Público	Distribución	Binario típico
development	Ingenieros	internal	Cliente de desarrollo + simulador/APK
preview	Control de calidad / partes interesadas	internal	IPA/APK con forma de lanzamiento
production	Usuarios finales	store	AAB + App Store IPA

eas build --profile development --platform all
eas build --profile preview --platform ios
eas build --profile production --platform android

Paso 2 - Vincular entornos de EAS

Crea variables en el panel de control de Expo → Project → Environment variables:

development   EXPO_PUBLIC_API_URL=https://api.dev.example.com
preview       EXPO_PUBLIC_API_URL=https://api.staging.example.com
production    EXPO_PUBLIC_API_URL=https://api.example.com

{
  "build": {
    "preview": { "environment": "preview" }
  }
}

environment extrae variables de EAS - no del .env.local del portátil
eas update --environment production debe coincidir con el perfil de producción - Reglas de lanzamiento y OTA

Paso 3 - Etiqueta blanca con app.config.ts

// app.config.ts - multi-marca desde env BRAND
type Brand = "acme" | "contoso";
 
const brand = (process.env.BRAND ?? "acme") as Brand;
 
const brands: Record<Brand, { name: string; bundleId: string; icon: string }> = {
  acme: {
    name: "Acme Shop",
    bundleId: "com.acme.shop",
    icon: "./brands/acme/icon.png",
  },
  contoso: {
    name: "Contoso Market",
    bundleId: "com.contoso.market",
    icon: "./brands/contoso/icon.png",
  },
};
 
const config: ExpoConfig = {
  name: brands[brand].name,
  slug: `shop-${brand}`,
  icon: brands[brand].icon,
  ios: { bundleIdentifier: brands[brand].bundleId },
  android: {
    package: brands[brand].bundleId,
    adaptiveIcon: { foregroundImage: brands[brand].icon, backgroundColor: "#fff" },
  },
};
 
export default config;

// eas.json - un perfil por marca para producción
{
  "build": {
    "production-acme": {
      "extends": "production",
      "env": { "BRAND": "acme" },
      "environment": "production-acme"
    },
    "production-contoso": {
      "extends": "production",
      "env": { "BRAND": "contoso" },
      "environment": "production-contoso"
    }
  }
}

eas build --profile production-acme --platform all
eas build --profile production-contoso --platform all

Cada marca necesita un projectId separado o un aislamiento cuidadoso de canales por ID de paquete
Certificados iOS y almacenes de claves de Android separados por bundleIdentifier / package

Herencia de perfil con extends

Comparte configuración entre perfiles:

{
  "build": {
    "base": {
      "node": "22.11.0",
      "resourceClass": "medium"
    },
    "development": {
      "extends": "base",
      "developmentClient": true,
      "distribution": "internal"
    },
    "production": {
      "extends": "base",
      "distribution": "store",
      "autoIncrement": true
    },
    "production-ios-simulator": {
      "extends": "production",
      "ios": { "simulator": true },
      "distribution": "internal"
    }
  }
}

extends fusiona claves padre - las anulaciones secundarias ganan
Usa para compilaciones de simulador Detox, Maestro CI y pines de versión de Node compartidos

Perfiles vs sabores de producto de Android

Expo CNG generalmente usa un applicationId de Gradle por prebuild impulsado por app.config.ts:

eas.json profile  →  APP_VARIANT env  →  app.config.ts  →  applicationId

Los sabores de producto de Android nativo en build.gradle son posibles en proyectos brownfield pero entran en conflicto con la regeneración de CNG. Prefiere:

app.config.ts dinámico para ID de paquete, nombre e iconos
Perfiles de EAS separados por variante
Complementos de configuración para recursos nativos específicos del sabor si es inevitable

Consulta Conceptos básicos de Prebuild - los sabores de producto de android/app/build.gradle editados a mano se pierden en prebuild limpio.

Alineación de canal y tiempo de ejecución

// app.config.ts
runtimeVersion: {
  policy: "fingerprint",
},
updates: {
  url: "https://u.expo.dev/<project-id>",
},

{
  "build": {
    "preview": { "channel": "preview" },
    "production": { "channel": "production" }
  }
}

eas update --channel preview --environment preview --message "QA fix"
eas update --channel production --environment production --message "Hotfix"

El canal en el binario debe coincidir con el canal en eas update
Diferentes sabores con diferentes huellas dactilares nativas necesitan diferentes versiones en tiempo de ejecución

Preguntas frecuentes

¿Pueden instalarse desarrollo y producción en el mismo teléfono?

Sí si bundleIdentifier / package difieren - usa sufijos APP_VARIANT como .dev y .staging.
No si comparten el mismo ID - la nueva instalación reemplaza la aplicación antigua.

¿Cuántos perfiles deberíamos tener?

Comienza con tres: desarrollo, vista previa y producción.
Agrega perfiles específicos de marca o plataforma con extends cuando sea necesario.
Evita perfiles nombrados por ingeniero ("jane-debug") - usa entornos y canales en su lugar.

¿Debería la vista previa usar distribución de tienda o interna?

internal para APK/ad hoc e iteración rápida.
store + TestFlight interno cuando control de calidad necesita firma idéntica a la producción - Distribución de TestFlight.

¿Cómo comparten aplicaciones de etiqueta blanca un repositorio?

Base de código única + env BRAND + credenciales separadas por nombre de paquete.
Proyectos de EAS separados o aislamiento de canal estricto por marca.
Documenta qué perfil mapea a cuál Play Console / aplicación de App Store Connect.

Relacionado

Conceptos básicos de EAS Build - fundamentos de perfil
Credenciales y aprovisionamiento de iOS - firma por ID de paquete
Almacenes de claves y firma de Android - almacenes de claves por paquete
Distribución interna - mecánica de instalación de vista previa
../cng-prebuild/prebuild-basics/prebuild-basics.md - app.config impulsa IDs nativos
../cng-prebuild/config-plugins-in-cng/config-plugins-in-cng.md - mutaciones nativas específicas del sabor
../ios-platform/ios-basics-for-rn-devs/ios-basics-for-rn-devs.md - reglas de identificador de paquete
../android-platform/android-basics-for-rn-devs/android-basics-for-rn-devs.md - applicationId vs namespace
../expo-rules/release-and-ota-rules/release-and-ota-rules.md - política de canal y tiempo de ejecución

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

Receta

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

// eas.json - línea base de tres entornos
{
  "cli": { "version": ">= 16.0.0", "appVersionSource": "remote" },
  "build": {
    "development": {
      "developmentClient": true,
      "distribution": "internal",
      "environment": "development",
      "channel": "development"
    },
    "preview": {
      "distribution": "internal",
      "environment": "preview",
      "channel": "preview"
    },
    "production": {
      "distribution": "store",
      "environment": "production",
      "channel": "production",
      "autoIncrement": true
    }
  }
}

// app.config.ts - APP_VARIANT del entorno de eas.json
import type { ExpoConfig } from "expo/config";
 
const variant = process.env.APP_VARIANT ?? "production";
 
const bundleIds: Record<string, string> = {
  development: "com.example.shopapp.dev",
  preview: "com.example.shopapp.staging",
  production: "com.example.shopapp",
};
 
const config: ExpoConfig = {
  name: variant === "production" ? "Shop" : `Shop (${variant})`,
  slug: "shop-app",
  ios: { bundleIdentifier: bundleIds[variant] },
  android: { package: bundleIds[variant] },
  extra: {
    apiUrl: process.env.EXPO_PUBLIC_API_URL,
    eas: { projectId: "00000000-0000-0000-0000-000000000000" },
  },
};
 
export default config;

// eas.json - pasar variante al prebuild
{
  "build": {
    "preview": {
      "env": { "APP_VARIANT": "preview" },
      "environment": "preview"
    }
  }
}

Cuándo usar esto:

Staging y producción deben instalarse lado a lado en el mismo dispositivo.
Las marcas de etiqueta blanca comparten una base de código con iconos e IDs de paquete diferentes.
Control de calidad necesita URLs de API de vista previa sin arriesgar datos de producción.
Los canales de EAS Update no deben contaminarse entre entornos.

Ejemplo funcional

Paso 1 - Definir responsabilidades del perfil

Perfil	Público	Distribución	Binario típico
development	Ingenieros	internal	Cliente de desarrollo + simulador/APK
preview	Control de calidad / partes interesadas	internal	IPA/APK con forma de lanzamiento
production	Usuarios finales	store	AAB + App Store IPA

eas build --profile development --platform all
eas build --profile preview --platform ios
eas build --profile production --platform android

Paso 2 - Vincular entornos de EAS

Crea variables en el panel de control de Expo → Project → Environment variables:

development   EXPO_PUBLIC_API_URL=https://api.dev.example.com
preview       EXPO_PUBLIC_API_URL=https://api.staging.example.com
production    EXPO_PUBLIC_API_URL=https://api.example.com

{
  "build": {
    "preview": { "environment": "preview" }
  }
}

environment extrae variables de EAS - no del .env.local del portátil
eas update --environment production debe coincidir con el perfil de producción - Reglas de lanzamiento y OTA

Paso 3 - Etiqueta blanca con app.config.ts

// app.config.ts - multi-marca desde env BRAND
type Brand = "acme" | "contoso";
 
const brand = (process.env.BRAND ?? "acme") as Brand;
 
const brands: Record<Brand, { name: string; bundleId: string; icon: string }> = {
  acme: {
    name: "Acme Shop",
    bundleId: "com.acme.shop",
    icon: "./brands/acme/icon.png",
  },
  contoso: {
    name: "Contoso Market",
    bundleId: "com.contoso.market",
    icon: "./brands/contoso/icon.png",
  },
};
 
const config: ExpoConfig = {
  name: brands[brand].name,
  slug: `shop-${brand}`,
  icon: brands[brand].icon,
  ios: { bundleIdentifier: brands[brand].bundleId },
  android: {
    package: brands[brand].bundleId,
    adaptiveIcon: { foregroundImage: brands[brand].icon, backgroundColor: "#fff" },
  },
};
 
export default config;

// eas.json - un perfil por marca para producción
{
  "build": {
    "production-acme": {
      "extends": "production",
      "env": { "BRAND": "acme" },
      "environment": "production-acme"
    },
    "production-contoso": {
      "extends": "production",
      "env": { "BRAND": "contoso" },
      "environment": "production-contoso"
    }
  }
}

eas build --profile production-acme --platform all
eas build --profile production-contoso --platform all

Cada marca necesita un projectId separado o un aislamiento cuidadoso de canales por ID de paquete
Certificados iOS y almacenes de claves de Android separados por bundleIdentifier / package

Herencia de perfil con extends

Comparte configuración entre perfiles:

{
  "build": {
    "base": {
      "node": "22.11.0",
      "resourceClass": "medium"
    },
    "development": {
      "extends": "base",
      "developmentClient": true,
      "distribution": "internal"
    },
    "production": {
      "extends": "base",
      "distribution": "store",
      "autoIncrement": true
    },
    "production-ios-simulator": {
      "extends": "production",
      "ios": { "simulator": true },
      "distribution": "internal"
    }
  }
}

extends fusiona claves padre - las anulaciones secundarias ganan
Usa para compilaciones de simulador Detox, Maestro CI y pines de versión de Node compartidos

Perfiles vs sabores de producto de Android

Expo CNG generalmente usa un applicationId de Gradle por prebuild impulsado por app.config.ts:

eas.json profile  →  APP_VARIANT env  →  app.config.ts  →  applicationId

Los sabores de producto de Android nativo en build.gradle son posibles en proyectos brownfield pero entran en conflicto con la regeneración de CNG. Prefiere:

app.config.ts dinámico para ID de paquete, nombre e iconos
Perfiles de EAS separados por variante
Complementos de configuración para recursos nativos específicos del sabor si es inevitable

Consulta Conceptos básicos de Prebuild - los sabores de producto de android/app/build.gradle editados a mano se pierden en prebuild limpio.

Alineación de canal y tiempo de ejecución

// app.config.ts
runtimeVersion: {
  policy: "fingerprint",
},
updates: {
  url: "https://u.expo.dev/<project-id>",
},

{
  "build": {
    "preview": { "channel": "preview" },
    "production": { "channel": "production" }
  }
}

eas update --channel preview --environment preview --message "QA fix"
eas update --channel production --environment production --message "Hotfix"

El canal en el binario debe coincidir con el canal en eas update
Diferentes sabores con diferentes huellas dactilares nativas necesitan diferentes versiones en tiempo de ejecución

Preguntas frecuentes

¿Pueden instalarse desarrollo y producción en el mismo teléfono?

Sí si bundleIdentifier / package difieren - usa sufijos APP_VARIANT como .dev y .staging.
No si comparten el mismo ID - la nueva instalación reemplaza la aplicación antigua.

¿Cuántos perfiles deberíamos tener?

Comienza con tres: desarrollo, vista previa y producción.
Agrega perfiles específicos de marca o plataforma con extends cuando sea necesario.
Evita perfiles nombrados por ingeniero ("jane-debug") - usa entornos y canales en su lugar.

¿Debería la vista previa usar distribución de tienda o interna?

internal para APK/ad hoc e iteración rápida.
store + TestFlight interno cuando control de calidad necesita firma idéntica a la producción - Distribución de TestFlight.

¿Cómo comparten aplicaciones de etiqueta blanca un repositorio?

Base de código única + env BRAND + credenciales separadas por nombre de paquete.
Proyectos de EAS separados o aislamiento de canal estricto por marca.
Documenta qué perfil mapea a cuál Play Console / aplicación de App Store Connect.

Relacionado

Conceptos básicos de EAS Build - fundamentos de perfil
Credenciales y aprovisionamiento de iOS - firma por ID de paquete
Almacenes de claves y firma de Android - almacenes de claves por paquete
Distribución interna - mecánica de instalación de vista previa
../cng-prebuild/prebuild-basics/prebuild-basics.md - app.config impulsa IDs nativos
../cng-prebuild/config-plugins-in-cng/config-plugins-in-cng.md - mutaciones nativas específicas del sabor
../ios-platform/ios-basics-for-rn-devs/ios-basics-for-rn-devs.md - reglas de identificador de paquete
../android-platform/android-basics-for-rn-devs/android-basics-for-rn-devs.md - applicationId vs namespace
../expo-rules/release-and-ota-rules/release-and-ota-rules.md - política de canal y tiempo de ejecución

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

Perfiles de compilación y sabores

Buscar en la documentación

Perfiles de compilación y sabores