chore: configure firebase app distribution for dev debug builds on demand (WPB-27685)

[yamilmedina]

https://wearezeta.atlassian.net/browse/WPB-27685

---

PR Submission Checklist for internal contributors

• The PR Title

  • conforms to the style of semantic commits messages¹ supported in Wire's Github Workflow²
  • contains a reference JIRA issue number like SQPIT-764
  • answers the question: If merged, this PR will: ... ³

• The PR Description

  • is free of optional paragraphs and you have filled the relevant parts to the best of your ability

---

What's new in this PR?

• add firebase app distribution configs
  • this is only for CI, so local development workflows are unaffected (no need to config credentials for example)
• add manual gh workflow to build
  • from a PR latest successful build apk
  • from a branch to build and deploy
• align package id to correct existing firebase config

---

PR Post Submission Checklist for internal contributors (Optional)

• Wire's Github Workflow has automatically linked the PR to a JIRA issue

---

PR Post Merge Checklist for internal contributors

• If any soft of configuration variable was introduced by this PR, it has been added to the relevant documents and the CI jobs have been updated.

---

References

1. https://sparkbox.com/foundry/semantic_commit_messages
2. https://github.com/wireapp/.github#usage
3. E.g. feat(conversation-list): Sort conversations by most emojis in the title #SQPIT-764.

[AndroidBob]

New ADR(s) in this PR 📚:

14. Firebase App Distribution for Dev builds

Date: 2026-08-20

Status

Accepted

Context

We need to distribute DevDebug APKs to testers without adding App Distribution uploads to the
shared build workflow. Firebase App Distribution requires the APK package name to match the
selected Firebase Android app.

Decision

Use the Firebase CLI from the distribution workflow. CI writes
FIREBASE_APP_DISTRIBUTION_SERVICE_ACCOUNT_JSON to a temporary credentials file and passes it as
Application Default Credentials. Local builds do not include App Distribution tooling or tasks.

Use a manual Distribute Dev Build workflow for uploads. The workflow accepts a PR number to reuse
the existing DevDebug artifact from its successful Develop PR build. Without a PR number, it builds
DevDebug from the branch selected when the workflow is dispatched.

Dev's base application ID is com.wire.android.dev, so DevDebug uses
com.wire.android.dev.debug, matching the Firebase Android app used for distribution.

Consequences

• App Distribution is opt-in and does not alter the shared build workflow.
• The Dev package-ID change does not change firebase_app_id, firebase_push_sender_id, or the
  Firebase project used for push notifications.
• Existing com.waz.zclient.dev.debug installations do not update in place and should be treated
  as ephemeral Dev installations.

[yamilmedina]

@claude review

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 52.29%. Comparing base (39f6116) to head (d1d61cc).
⚠️ Report is 2 commits behind head on develop.

Additional details and impacted files

@@           Coverage Diff            @@
##           develop    #5196   +/-   ##
========================================
  Coverage    52.29%   52.29%           
========================================
  Files          668      668           
  Lines        24036    24036           
  Branches      3962     3962           
========================================
  Hits         12570    12570           
  Misses       10302    10302           
  Partials      1164     1164           

---

Continue to review full report in Codecov by Harness.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 420e046...d1d61cc. Read the comment docs.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[github-actions]

Test Results

2 276 tests   2 276 ✅  2m 13s ⏱️
  250 suites      0 💤
  250 files        0 ❌

Results for commit d1d61cc.

♻️ This comment has been updated with latest results.

[github-actions]

APKs built during tests are available here. Scroll down to Artifacts!

[github-actions]

APKs built during tests are available here. Scroll down to Artifacts!