Skip to content

Commit

Permalink
Update documentation for 3.0 release.
Browse files Browse the repository at this point in the history
  • Loading branch information
orrc committed Dec 2, 2019
1 parent 02b6960 commit 3c038cc
Show file tree
Hide file tree
Showing 2 changed files with 17 additions and 5 deletions.
8 changes: 8 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,13 @@
# Version history

## 3.0
December 2, 2019

- Android App Bundles (AAB files) are now supported by the existing build steps (thanks to [andrewjapar](https://github.com/andrewjapar) and [Joe Hansche](https://github.com/jhansche))
- Expansion files uploaded during a build can be applied to other APKs uploaded in the same build (thanks to [Mikhail Korotetsky](https://github.com/mkorotetsky))
- Increased minimum Jenkins version to 2.138.4
- Migrated documentation and changelog to GitHub, as the Jenkins wiki is deprecated

## 2.0
July 17, 2019

Expand Down
14 changes: 9 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,8 +8,8 @@ Enables Jenkins to manage and upload Android app files (AAB or APK) to Google Pl

## Features
- Uploading Android App Bundle (AAB) or APK files to Google Play
- This includes apps which use Multiple APK support
- ProGuard `mapping.txt` files can also be associated with each app file, for deobfuscating stacktraces
- This includes apps which use Multiple APK support
- ProGuard `mapping.txt` files can also be associated with each app file, for deobfuscating stacktraces
- Uploading APK expansion (.obb) files
- With the option to re-use expansion files from existing APKs, e.g. for patch releases
- Assigning apps to internal, alpha, beta or production release tracks
Expand All @@ -26,7 +26,7 @@ Enables Jenkins to manage and upload Android app files (AAB or APK) to Google Pl

## Requirements
### Jenkins
Jenkins [version 2.60.3](https://jenkins.io/changelog-stable#v2.60.3) or newer is required.
Jenkins [version 2.138.4](https://jenkins.io/changelog-stable#v2.138.4) or newer is required.

### Google Play publisher account
For the initial setup only, you must have access to the Google account
Expand Down Expand Up @@ -128,10 +128,14 @@ The following job setup process is demonstrated in this video:

###### APK expansion files
You can optionally add up to two [expansion
files](https://developer.android.com/google/play/expansion-files.html)
files](https://developer.android.com/google/play/expansion-files.html) (main + patch)
for each APK being uploaded.

A list of expansion files can be specified in the same way as APKs, though note that they must be named in the format `[main|patch]``.<expansion-version>.<package-name>.obb`.
A list of expansion files can be specified in the same way as APKs, though note that they must be named in the format `[main|patch]``.<apk-version>.<package-name>.obb`.

You can also enable the "Re-use expansion files from existing APKs where necessary" option, which will automatically the most-recent expansion files to newly uploaded APKs.

Similarly, if you want to apply the same expansion file(s) to multiple APKs being uploaded, you can do so. Name the expansion file(s) according to the _lowest_ version code being uploaded: the expansion file will then be uploaded, and applied to the remaining APKs with higher version codes.

See the inline help for more details.

Expand Down

0 comments on commit 3c038cc

Please sign in to comment.