API リファレンス

Packages

インストール済みアプリの一覧表示、APK メタデータの表示、タグの管理を行います。

型定義

bash
type Package {
  id: ID!                    # package name e.g. "com.example.app"
  name: String!              # display name
  type: String!              # "user" | "system"
  version: String!           # "versionName (versionCode)"
  path: String!              # APK path
  size: Int!                 # bytes
  certs: [PackageCert!]!
  installedAt: String!       # ISO 8601
  updatedAt: String!
  tags: [Tag!]!
}

type PackageCert {
  issuer: String!
  subject: String!
  serialNumber: String!
  validFrom: String!
  validTo: String!
}

type PackageStatus {
  id: ID!                 # package name
  installed: Boolean!
  updatedAt: String       # ISO 8601, null when not installed
}

type PackageInstallPending {
  packageName: String!
  updatedAt: String!
  isNew: Boolean!
}

操作

query

packages

インストール済みパッケージを検索します。クエリを空にするとすべて一覧表示されます。

bash
query GetPackages($offset: Int!, $limit: Int!, $query: String!, $sortBy: FileSortBy!) {
  packages(offset: $offset, limit: $limit, query: $query, sortBy: $sortBy) {
    id name type version path size
    certs { issuer subject serialNumber validFrom validTo }
    installedAt updatedAt
    tags { id name }
  }
}
query

packageStatuses

パッケージ名リストのインストール状態と updatedAt タイムスタンプを検索します。

bash
query GetPackageStatuses($ids: [ID!]!) {
  packageStatuses(ids: $ids) { id installed updatedAt }
}
query

packageCount

クエリに一致するパッケージの数をカウントします。

bash
query GetPackageCount($query: String!) {
  packageCount(query: $query)
}
mutation

installPackage

絶対ファイルパスで APK をインストール (または更新) します。パッケージ名、最終更新時刻、およびパッケージが新しくインストールされたかどうかを返します。

bash
mutation InstallPackage($path: String!) {
  installPackage(path: $path) { packageName updatedAt isNew }
}
mutation

uninstallPackages

各パッケージ ID に対してシステムのアンインストール プロンプトを起動します。ユーザーがデバイス上で確認する必要があります。

bash
mutation UninstallPackages($ids: [ID!]!) {
  uninstallPackages(ids: $ids)
}