API リファレンス

パッケージ

機能の対応状況は app.capabilities、認可は app.access とホストの権限で確認してください。例は合成値を使用しています。呼び出す前にパス、ID、入力、フィルターを置き換えてください。

型定義

graphql
type Mutation {
  installPackage(path: String!): PackageInstallPending!
  uninstallPackages(ids: [ID!]!): Boolean!
}

type Query {
  packageCount(query: String!): Int!
  packageManifest(id: ID!): String!
  packageStatuses(ids: [ID!]!): [PackageStatus!]!
  packages(query: String!, offset: Int!, limit: Int!, sortBy: FileSortBy!): [Package!]!
}

type Certificate {
	issuer: String!
	subject: String!
	serialNumber: String!
	validFrom: Instant!
	validTo: Instant!
}

enum FileSortBy {
	UPDATED_AT_ASC
	UPDATED_AT_DESC
	SIZE_ASC
	SIZE_DESC
	NAME_ASC
	NAME_DESC
}

scalar Instant

scalar Long

type Package {
	id: ID!
	name: String!
	type: PackageType!
	version: String!
	path: String!
	size: Long!
	certs: [Certificate!]!
	installedAt: Instant!
	updatedAt: Instant!
}

type PackageInstallPending {
	id: ID!
	updatedAt: Instant
	isNew: Boolean!
}

type PackageStatus {
	id: ID!
	exists: Boolean!
	updatedAt: Instant
}

enum PackageType {
	SYSTEM
	
	USER
}

操作

mutation

installPackage

絶対ファイルパスを指定して APK をインストールまたは更新します。パッケージ名、最終更新時刻、新規インストールかどうかを返します。

graphql
mutation installPackage($path: String!) {
  installPackage(path: $path) { id updatedAt isNew }
}
mutation

uninstallPackages

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

graphql
# Launch system uninstall requests; true means initiated, not uninstalled. Confirm removal with packageStatuses.
mutation uninstallPackages($ids: [ID!]!) {
  uninstallPackages(ids: $ids)
}
query

packageCount

クエリに一致するパッケージ数を数えます。

graphql
query packageCount($query: String!) {
  packageCount(query: $query)
}
query

packageManifest

指定したインストール済みパッケージのマニフェストを読み取ります。

graphql
query packageManifest($id: ID!) {
  packageManifest(id: $id)
}
query

packageStatuses

パッケージ名のリストについて、インストール状態と updatedAt タイムスタンプを調べます。

graphql
query packageStatuses($ids: [ID!]!) {
  packageStatuses(ids: $ids) { id exists updatedAt }
}
query

packages

インストール済みパッケージを検索します。すべて表示するには query を空にします。

graphql
query packages($query: String!, $offset: Int!, $limit: Int!, $sortBy: FileSortBy!) {
  packages(query: $query, offset: $offset, limit: $limit, sortBy: $sortBy) { id name type version path size installedAt updatedAt }
}