jeans/developers.home-assistant
jeans/developers.home-assistant
1
0
Fork 0
mirror of https://github.com/home-assistant/developers.home-assistant.git synced 2025-06-19 08:36:29 +00:00
Code Issues Packages Projects Releases Wiki Activity
developers.home-assistant/docs/android/release.md
Timothy 74f8978d63
Add release build information (#2638) 
* Add instruction for release build

* Add missing links to the Google Play Store

* Update release.md
2025-04-09 12:59:10 -07:00

2.4 KiB
Raw Blame History

title, sidebar_label
title sidebar_label
Android release process Release process

Android release process

This document outlines the steps to take an Android application from development on your machine to production for end users. It also covers the roles of CI/CD pipelines, internal testing, beta testing, and Google Play Store validation.

Release workflow: from debug to production

Development and debug builds

  • During development, you typically build the debug application on your local machine.
  • Once your changes are ready, you push a Pull Request (PR) to the repository.

Continuous integration (CI)

  • The CI system automatically:
    • Builds the application.
    • Runs linters and tests to ensure code quality.
  • If the PR is approved and merged into the main branch:
    • The CI builds the release application.
    • The release build is pushed to the internal tester group on both the Google Play Store and Firebase.

:::note You can download pre-built APKs for every commit on the main branch from the GitHub Actions page. :::

Internal testing

  • Internal testers validate the release build to ensure functionality.
  • Due to the app's complexity, not all features can be tested exhaustively during this phase.

Weekly beta releases

  • Every week, the latest version of the main branch is pushed to the open beta channel.
  • Open beta users help test the application in real-world scenarios and report issues.

:::note You can join the beta program directly through the Google Play Store. :::

Production release

If the beta version is stable and approved by maintainers, it is promoted to production, making it available to all users.

:::note You can find the app on the Google Play Store. :::

Google Play Store validation

  • Google validates applications when they are pushed to the open beta phase.
  • Validation times can vary:
    • It may take more than a week in some cases.
    • Since releases are weekly, the previous beta release might still be under validation when a new beta is submitted. If this happens the previous beta is removed and not validated by Google.
  • This delay does not block the release process but requires careful planning to ensure timely updates.