{"id":15660454,"url":"https://github.com/vacxe/google-play-cli","last_synced_at":"2025-04-15T22:50:33.129Z","repository":{"id":64526579,"uuid":"246494735","full_name":"Vacxe/google-play-cli","owner":"Vacxe","description":"CLI tool for publish and management application in Google Play Console","archived":false,"fork":false,"pushed_at":"2025-02-13T12:43:27.000Z","size":286,"stargazers_count":26,"open_issues_count":4,"forks_count":2,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-12T01:11:31.753Z","etag":null,"topics":["android","cicd","cli","distribution","googleplay","playstore","tooling"],"latest_commit_sha":null,"homepage":null,"language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Vacxe.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-03-11T06:41:21.000Z","updated_at":"2025-03-16T08:43:01.000Z","dependencies_parsed_at":"2024-05-01T01:45:46.567Z","dependency_job_id":"213d5854-c592-4979-8b55-04c29b31c327","html_url":"https://github.com/Vacxe/google-play-cli","commit_stats":null,"previous_names":["vacxe/google-play-cli"],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vacxe%2Fgoogle-play-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vacxe%2Fgoogle-play-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vacxe%2Fgoogle-play-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vacxe%2Fgoogle-play-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Vacxe","download_url":"https://codeload.github.com/Vacxe/google-play-cli/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249167434,"owners_count":21223505,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","cicd","cli","distribution","googleplay","playstore","tooling"],"created_at":"2024-10-03T13:21:47.384Z","updated_at":"2025-04-15T22:50:33.103Z","avatar_url":"https://github.com/Vacxe.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Google play CLI\nTransparent CLI tooling for managing Google Play Console.\n\n## Table of Contents\n\n- [Introduction](#introduction)\n- [Installation](#installation)\n  - [Homebrew](#homebrew)\n  - [Docker](#docker)\n  - [GitHub Actions](#github-action)\n- [How to use CLI](#how-to-use-cli-directly)\n\nThis library is transparent CLI wrapper for official [Google Play Java Library](https://developers.google.com/android-publisher/api-ref)\n\n## Introduction\n\nPrevious 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.\n* [Gradle Triple-T Plugin](https://github.com/Triple-T/gradle-play-publisher)\n  * 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.\n  * Not flexible enough - suitable only for Apk/Bundle upload\n* [r0adkll/sign-android-release](https://github.com/r0adkll/sign-android-release)\n  * Not flexible enough - suitable only for Apk/Bundle upload\n\n**Advantages of this project**\n  * Core: Transparent CLI wrapper for Official Google Play Console library\n  * 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.\n  * Docker: Transparent environment for CLI, as well JQ for easier Json response management in case of custom actions\n  * GitHub Action: Transparent wrapper for Docker, with amount of custom *templates* to simplify day to day actions like upload apk\n\n## Installation\n\n### Homebrew\n\n```\nbrew tap vacxe/tap\nbrew install vacxe/tap/googleplaycli\n```\n\n### [Docker](https://github.com/Vacxe/google-play-cli-kt/pkgs/container/google-play-cli)\n\n* Docker Registry\n```\nvacxe/google-play-cli:\u003cVERSION\u003e\n```\n\n* GitHub Registry\n```\nghcr.io/vacxe/google-play-cli:\u003cVERSION\u003e\n```\n\n### [GitHub Action](https://github.com/marketplace/actions/google-play-console)\n\n[GitHub Action](https://github.com/marketplace/actions/google-play-console) `vacxe/google-play-cli-kt` is transparent wrapper over [Docker](https://github.com/Vacxe/google-play-cli-kt/pkgs/container/google-play-cli) `google-play-cli-kt`, what contains transparent CLI warapper for [Google Play Java Library](https://developers.google.com/android-publisher/api-ref). It can provide for you possibility to write any custom scripts in depends on you needs or use one of **[Available templates](github-action/README.md)**.\n\n*Example of APK uploading template:*\n```yaml\n- uses: vacxe/google-play-cli-kt@master\n  with:\n    template: apk-upload\n    service-account-json: ${{ secrets.SERVICE_ACCOUNT_JSON }}\n    version-code: ${{ github.run_number }}\n    package-name: \u003cpackage name\u003e\n    path-to-apk: \u003cpath to apk\u003e\n    track: internal\n    status: draft\n```\n\n## How to use CLI directly\n* Before you started you should obtain a `serviceAccount.json`\n\n  Goto: Google Play Console -\u003e Developer Account -\u003e Api access -\u003e Service Accounts -\u003e CREATE SERVICE ACCOUNT\n  Follow the instruction and grant the access for service account\n* Try basic command\n  * ```google-play-cli --help``` - list of all commands\n  * ```google-play-cli apk list --config-file service_account.json --package-name \u003cyour uploaded apk package name\u003e```\n\nExample how to upload apk with step by step explanation:\n\n* Let configure few environment variables first, what will make our next CLI calls much easier\n```shell\n# If proxy needed\n#PLAYSTORE_PROXY=192.168.0.1:3128\n\n# Increase connection timeout\n#PLAYSTORE_CONNECTION_TIMEOUT=PT6M\n\nexport PLAYSTORE_SERVICE_ACCOUNT_JSON_FILE=\"/path/to/service_account.json\"\n# Or set a plain text\n#export PLAYSTORE_SERVICE_ACCOUNT_JSON_CONTENT=\"CONTENT OF JSON\"\nexport APP_PACKAGE_NAME=\"com.my.package\"\n```\n\nExporting is not required, but if you will not decide to do it you may need to add for each command\n* `--config-file \"/path/to/service_account.json\"`\n  * or `--config-content \"CONTENT OF JSON\"`\n* `--package-name \"com.my.package\"`\n\n*Tip: On CI you can add service account json file as a secret to environment variable*\n\n---\n\n* First of all you may need to create **edit_id**\n```shell\nedit_id=$(google-play-cli edit create)\n```\n* With existing `edit_id` you can do any modifications in Play Console, let's upload APK\n```shell\ngoogle-play-cli apk upload --edit-id $edit_id --apk \"path/to/my.apk\"\n```\n* APK been uploaded, we need to assign it to `track`. Let choice `internal` track and status will be `draft`, as well we need to know version code (for example `42`)\n```shell\ngoogle-play-cli tracks update --edit-id $edit_id --track \"internal\" --status \"draft\" --version-code \"42\"\n```\n* As a non-required step you can validate your edit at any time\n```shell\ngoogle-play-cli edit validate --edit-id $edit_id\n```\n* And as last step - commit your changes\n```shell\ngoogle-play-cli edit commit --edit-id $edit_id\n```\n\n## License\n\n-------\n\n    Licensed under the Apache License, Version 2.0 (the \"License\");\n    you may not use this file except in compliance with the License.\n    You may obtain a copy of the License at\n\n       http://www.apache.org/licenses/LICENSE-2.0\n\n    Unless required by applicable law or agreed to in writing, software\n    distributed under the License is distributed on an \"AS IS\" BASIS,\n    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n    See the License for the specific language governing permissions and\n    limitations under the License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvacxe%2Fgoogle-play-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvacxe%2Fgoogle-play-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvacxe%2Fgoogle-play-cli/lists"}