$gpc system-apks

--json--dry-run

Create and manage system APKs for OEM pre-installs from published App Bundles.

usagegpc system-apks <subcommand> [options]

Overview

System APKs are device-specific APKs generated from your published App Bundle, suitable for inclusion in OEM system images. This is used by device manufacturers who pre-install your app on their devices.

Commands

Command	Description
system-apks list	List system APK variants for a version code
system-apks get	Get details of a system APK variant
system-apks create	Create a system APK variant from a device spec
system-apks download	Download a system APK variant

system-apks list

List all system APK variants previously created for a specific version code.

Synopsis

gpc system-apks list <version-code>

Example

gpc system-apks list 142 --app com.example.myapp

---

system-apks get

Get details of a specific system APK variant.

Synopsis

gpc system-apks get <version-code> <variant-id>

Example

gpc system-apks get 142 1 --app com.example.myapp --json

---

system-apks create

Create a new system APK variant from a device specification JSON file. The device spec defines the target ABI, locale, and screen density.

Synopsis

gpc system-apks create <version-code> --file <device-spec.json>

Options

Flag	Type	Default	Description
--file	string	(required)	JSON file with device spec data

Device Spec Format

{
  "deviceSpec": {
    "supportedAbis": ["arm64-v8a"],
    "supportedLocales": ["en-US"],
    "screenDensity": 420
  },
  "options": {
    "uncompressedNativeLibraries": true,
    "uncompressedDexFiles": false,
    "rotated": false
  }
}

Example

gpc system-apks create 142 \
  --app com.example.myapp \
  --file device-spec.json

Preview without creating:

gpc system-apks create 142 --file device-spec.json --dry-run

---

system-apks download

Download a previously created system APK variant to a local file.

Synopsis

gpc system-apks download <version-code> <variant-id> --output <path>

Options

Flag	Type	Default	Description
--output	string	(required)	Output file path

Example

gpc system-apks download 142 1 --output system-app.apk

Related

• generated-apks -- Device-specific APKs generated by Google Play
• releases -- Release management and uploads