Transparent CLI tooling for managing Google Play Console.
This library is transparent CLI wrapper for official Google Play Java Library
Previous libs what been used for application deployment contained disadvantages what blocked me from application delivery. As well, all libraries contains internal logic for uploading, but will be nice hot have some more transparent solution.
- Gradle Triple-T Plugin
- Integration with build system - Distribution should not be a part of build system. Its blocking us to create a reusable chains on CI. If project is huge, it will create a lot of overhead with evaluation project.
- Not flexible enough - suitable only for Apk/Bundle upload
- r0adkll/sign-android-release
- Not flexible enough - suitable only for Apk/Bundle upload
Advantages of this project
- Core: Transparent CLI wrapper for Official Google Play Console library
- Can be installed on host directly as CLI (via brew or binaries) or can be used via Docker or GitHub actions. You are able to test it locally before deployment.
- Docker: Transparent environment for CLI, as well JQ for easier Json response management in case of custom actions
- GitHub Action: Transparent wrapper for Docker, with amount of custom templates to simplify day to day actions like upload apk
brew tap vacxe/tap
brew install vacxe/tap/googleplaycli
- Docker Registry
vacxe/google-play-cli:<VERSION>
- GitHub Registry
ghcr.io/vacxe/google-play-cli:<VERSION>
GitHub Action vacxe/google-play-cli-kt
is transparent wrapper over Docker google-play-cli-kt
, what contains transparent CLI warapper for Google Play Java Library. It can provide for you possibility to write any custom scripts in depends on you needs or use one of Available templates.
Example of APK uploading template:
- uses: vacxe/google-play-cli-kt@master
with:
template: apk-upload
service-account-json: ${{ secrets.SERVICE_ACCOUNT_JSON }}
version-code: ${{ github.run_number }}
package-name: <package name>
path-to-apk: <path to apk>
track: internal
status: draft
-
Before you started you should obtain a
serviceAccount.json
Goto: Google Play Console -> Developer Account -> Api access -> Service Accounts -> CREATE SERVICE ACCOUNT Follow the instruction and grant the access for service account
-
Try basic command
google-play-cli --help
- list of all commandsgoogle-play-cli apk list --config-file service_account.json --package-name <your uploaded apk package name>
Example how to upload apk with step by step explanation:
- Let configure few environment variables first, what will make our next CLI calls much easier
# If proxy needed
#PLAYSTORE_PROXY=192.168.0.1:3128
# Increase connection timeout
#PLAYSTORE_CONNECTION_TIMEOUT=PT6M
export PLAYSTORE_SERVICE_ACCOUNT_JSON_FILE="/path/to/service_account.json"
# Or set a plain text
#export PLAYSTORE_SERVICE_ACCOUNT_JSON_CONTENT="CONTENT OF JSON"
export APP_PACKAGE_NAME="com.my.package"
Exporting is not required, but if you will not decide to do it you may need to add for each command
--config-file "/path/to/service_account.json"
- or
--config-content "CONTENT OF JSON"
- or
--package-name "com.my.package"
Tip: On CI you can add service account json file as a secret to environment variable
- First of all you may need to create edit_id
edit_id=$(google-play-cli edit create)
- With existing
edit_id
you can do any modifications in Play Console, let's upload APK
google-play-cli apk upload --edit-id $edit_id --apk "path/to/my.apk"
- APK been uploaded, we need to assign it to
track
. Let choiceinternal
track and status will bedraft
, as well we need to know version code (for example42
)
google-play-cli tracks update --edit-id $edit_id --track "internal" --status "draft" --version-code "42"
- As a non-required step you can validate your edit at any time
google-play-cli edit validate --edit-id $edit_id
- And as last step - commit your changes
google-play-cli edit commit --edit-id $edit_id
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.