Android Identity and Resources Plugin

Build a plugin that updates Android project identity, string resources, and Gradle defaults based on provided options.

Capabilities

Application identity

• When given applicationId, updates the Android package identifier in the manifest and the applicationId in the app-level Gradle config. @test

App label resource

• Writes the provided display name into the default app_name string resource and ensures the main application label references it. @test

Version and Gradle defaults

• Applies the provided versionCode and versionName to the defaultConfig of the app-level Gradle build file. @test

Additional resources

• Accepts an optional map of extra strings and ensures each entry is present in the Android string resources file without overwriting existing unrelated keys. @test

Implementation

@generates

API

export type AndroidBrandingOptions = {
  applicationId?: string;
  displayName: string;
  versionCode: number;
  versionName: string;
  extraStrings?: Record<string, string>;
};

export interface AppConfig {
  name?: string;
  android?: Record<string, unknown>;
  [key: string]: unknown;
}

export default function applyAndroidBranding(config: AppConfig, options: AndroidBrandingOptions): AppConfig;

Dependencies { .dependencies }

@expo/config-plugins { .dependency }

Provides helpers for Android manifest editing, string resources, and Gradle settings.

@satisfied-by