Manifest Safety Net

A utility that keeps an Android manifest aligned with project requirements while routing non-blocking issues through warnings.

Capabilities

Initialize manifest content

• When the manifest file is missing and fallbackXml is provided, initialize from the fallback, persist it, and continue using the parsed result. @test
• If the manifest file is missing and no fallback is supplied, throw a clear error describing the missing file. @test

Validate minimum SDK

• When the manifest's minSdkVersion is below minSdkVersion, raise an Android warning and update it to the required version. @test

Enforce feature flag metadata

• Ensure the <application> node contains a <meta-data android:name="com.example.feature.ENABLED" android:value="true">; add it when missing and warn when the previous value was not "true". @test

Persist formatted XML

• After all adjustments, write the manifest back to disk in readable XML, flush accumulated warnings, and return whether a write occurred plus the flushed warnings in call order. @test

Implementation

@generates

API

export interface ManifestSafetyOptions {
  manifestPath: string;
  fallbackXml?: string;
  minSdkVersion: number;
}

export interface ManifestSafetyResult {
  updated: boolean;
  warnings: string[];
}

export async function ensureManifestSafety(
  options: ManifestSafetyOptions
): Promise<ManifestSafetyResult>;

Dependencies { .dependencies }

@expo/config-plugins { .dependency }

Provides manifest XML helpers, validation utilities, and warning aggregation support.