From 29812f36c369584b9bffc59bab985ed911ffe2a5 Mon Sep 17 00:00:00 2001 From: dianaKhortiuk-frontegg Date: Mon, 29 Jun 2026 13:04:09 +0200 Subject: [PATCH] docs(android): declare applicationId before manifestPlaceholders in setup snippets The Android setup snippets in docs/setup.md and docs/usage.md drop `manifestPlaceholders = ["package_name": applicationId, ...]` into defaultConfig without showing applicationId above it. Customers paste the block at the top of defaultConfig, before their applicationId line; Groovy evaluates defaultConfig top-to-bottom, so applicationId resolves to null, the package_name placeholder is empty, and the AAR manifest merge fails. Match the SDK's working example apps (frontegg-android-kotlin app/embedded/ applicationId/multi-region build.gradle), which declare applicationId first and then reference it: show applicationId above the placeholders in setup.md, and tell readers in usage.md to add the block below their existing applicationId line, with an inline note on the package_name line. Co-Authored-By: Claude Opus 4.8 --- docs/setup.md | 5 +++++ docs/usage.md | 4 ++-- 2 files changed, 7 insertions(+), 2 deletions(-) diff --git a/docs/setup.md b/docs/setup.md index b178ba7..6cdbcb0 100644 --- a/docs/setup.md +++ b/docs/setup.md @@ -257,6 +257,11 @@ def fronteggClientId = "{{FRONTEGG_CLIENT_ID}}" android { defaultConfig { + // Keep your existing applicationId declared above manifestPlaceholders — the + // "package_name" placeholder below reads applicationId, so it must be set first. + // (If manifestPlaceholders is pasted above applicationId, package_name resolves + // to null and the AAR manifest merge fails.) + applicationId "com.your.company.app" manifestPlaceholders = [ "package_name" : applicationId, diff --git a/docs/usage.md b/docs/usage.md index 6eea01c..bdaa977 100644 --- a/docs/usage.md +++ b/docs/usage.md @@ -18,11 +18,11 @@ def fronteggDomain = "{{FRONTEGG_BASE_URL}}" // without https:// def fronteggClientId = "{{FRONTEGG_CLIENT_ID}}" ``` -3. Within the `android { defaultConfig { ... } }` section, add the following: +3. Within the `android { defaultConfig { ... } }` section, **below your existing `applicationId` line**, add the following. The `package_name` placeholder reads `applicationId`, so `applicationId` must already be declared above it — otherwise it resolves to `null` and the AAR manifest merge fails: ```groovy manifestPlaceholders = [ - "package_name" : applicationId, + "package_name" : applicationId, // your app's applicationId (declared above) "frontegg_domain" : fronteggDomain, "frontegg_client_id" : fronteggClientId ]