android-env 1.2.1__py3-none-any.whl → 1.2.3__py3-none-any.whl

android_env/proto/snapshot.proto

@@ -0,0 +1,169 @@
+// Copyright 2024 DeepMind Technologies Limited.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+// Copyright (C) 2018 The Android Open Source Project
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto2";
+
+// This file must be synchronized between
+//    Emulator (branch aosp/emu-master-dev):
+//        external/qemu/android/android-emu/android/snapshot/proto/snapshot.proto
+//
+//    Android Studio (branch goog/studio-master-dev):
+//        tools/adt/idea/android/src/com/android/emulator/snapshot.proto
+//
+// If you modify one, please modify the other.
+
+package emulator_snapshot;
+
+option java_package = "com.android.emulator.snapshot";
+
+message Image {
+  enum Type {
+    IMAGE_TYPE_UNKNOWN = 0;
+    IMAGE_TYPE_KERNEL = 1;
+    IMAGE_TYPE_KERNEL_RANCHU = 2;
+    IMAGE_TYPE_SYSTEM = 3;
+    IMAGE_TYPE_SYSTEM_COPY = 4;
+    IMAGE_TYPE_DATA = 5;
+    IMAGE_TYPE_DATA_COPY = 6;
+    IMAGE_TYPE_RAMDISK = 7;
+    IMAGE_TYPE_SDCARD = 8;
+    IMAGE_TYPE_CACHE = 9;
+    IMAGE_TYPE_VENDOR = 10;
+    IMAGE_TYPE_ENCRYPTION_KEY = 11;
+  }
+
+  optional Type type = 1;
+  optional string path = 2;
+  optional bool present = 3;
+  optional int64 size = 4;
+  optional int64 modification_time = 5;
+}
+
+message Host {
+  optional string gpu_driver = 4;
+  optional int32 hypervisor = 5;
+}
+
+message Config {
+  // Features are int32, not enums here to make sure we don't have to update
+  // one more protobuf definition with every single new feature flag, even
+  // when the code doesn't really care about the actual meaning for them,
+  // only for the values.
+  repeated int32 enabled_features = 1;
+
+  // This holds the renderer; int32 for the same reason as |enabled_features|.
+  optional int32 selected_renderer = 2;
+
+  optional int32 cpu_core_count = 3;
+  optional int64 ram_size_bytes = 4;
+}
+
+message SaveStats {
+  // Type of save
+  // 0: non-incremental
+  // 1: incremental
+  optional uint32 incremental = 1;
+  // Time taken to save.
+  optional uint64 duration = 2;
+  // How many changed bytes in RAM.
+  optional uint64 ram_changed_bytes = 3;
+}
+
+message Snapshot {
+  // Update every time when introducing some breaking changes that make the
+  // previous loading code break when trying to load the new snapshot.
+  // NOTE: if the old code is fine with just skipping the new fields or not
+  //       getting the meaning of new values, |version| should remain
+  //       unchanged.
+  optional int32 version = 1;
+
+  // Purely informative: when this snapshot was created, Unix timestamp.
+  optional int64 creation_time = 2;
+
+  // list of mounted disk images used during the snapshot creation.
+  repeated Image images = 3;
+
+  // Description of the host machine properties needed to load this snapshot.
+  optional Host host = 4;
+
+  // Description of the emulator configuration needed for this snapshot.
+  // NOTE: try not to duplicate the configuration that's already in
+  //       hardware-qemu.ini; only add what's either not there or what
+  //       could've been overridden during process initialization.
+  optional Config config = 5;
+
+  // Set if the snapshot failed to load during the last attempt.
+  // Code is up to the application to define, with 0 meaning 'not failed' just
+  // in case.
+  optional int64 failed_to_load_reason_code = 7;
+
+  // Set if data image is mounted.
+  // User build and userdebug build mount data partition at different time.
+  // But it should be done before boot finished, so this field is very likely
+  // to be true.
+  // We snapshot it here just in case someday we support snapshot during
+  // booting.
+  optional bool guest_data_partition_mounted = 8;
+
+  // Emulator rotation angle, in right angles (e.g. 1 is 90 degrees, 2 is 180
+  // etc).
+  optional int32 rotation = 9;
+
+  // Number of invalid loads / crashes that happened under this snapshot.
+  optional int32 invalid_loads = 10;
+
+  // Number of successful loads.
+  optional int32 successful_loads = 11;
+
+  // The name given to the snapshot by the user. Independent of the
+  // file name.
+  optional string logical_name = 12;
+
+  // The file name of this snapshot's parent. The parent is the
+  // snapshot that was loaded into the AVD prior to this snapshot
+  // being taken
+  optional string parent = 13;
+
+  // Arbitrary description added by the user
+  optional string description = 14;
+
+  // Record of save stats.
+  repeated SaveStats save_stats = 15;
+
+  // Folded state.
+  optional bool folded = 16;
+
+  // Emulator boot parameters
+  repeated string launch_parameters = 17;
+
+  // Emulator build ID
+  optional string emulator_build_id = 18;
+
+  // System image build ID
+  optional string system_image_build_id = 19;
+}

android_env/proto/snapshot_pb2.py

@@ -0,0 +1,47 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: android_env/proto/snapshot.proto
+# Protobuf Python Version: 5.29.0
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(
+    _runtime_version.Domain.PUBLIC,
+    5,
+    29,
+    0,
+    '',
+    'android_env/proto/snapshot.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n android_env/proto/snapshot.proto\x12\x11\x65mulator_snapshot\"\xaf\x03\n\x05Image\x12+\n\x04type\x18\x01 \x01(\x0e\x32\x1d.emulator_snapshot.Image.Type\x12\x0c\n\x04path\x18\x02 \x01(\t\x12\x0f\n\x07present\x18\x03 \x01(\x08\x12\x0c\n\x04size\x18\x04 \x01(\x03\x12\x19\n\x11modification_time\x18\x05 \x01(\x03\"\xb0\x02\n\x04Type\x12\x16\n\x12IMAGE_TYPE_UNKNOWN\x10\x00\x12\x15\n\x11IMAGE_TYPE_KERNEL\x10\x01\x12\x1c\n\x18IMAGE_TYPE_KERNEL_RANCHU\x10\x02\x12\x15\n\x11IMAGE_TYPE_SYSTEM\x10\x03\x12\x1a\n\x16IMAGE_TYPE_SYSTEM_COPY\x10\x04\x12\x13\n\x0fIMAGE_TYPE_DATA\x10\x05\x12\x18\n\x14IMAGE_TYPE_DATA_COPY\x10\x06\x12\x16\n\x12IMAGE_TYPE_RAMDISK\x10\x07\x12\x15\n\x11IMAGE_TYPE_SDCARD\x10\x08\x12\x14\n\x10IMAGE_TYPE_CACHE\x10\t\x12\x15\n\x11IMAGE_TYPE_VENDOR\x10\n\x12\x1d\n\x19IMAGE_TYPE_ENCRYPTION_KEY\x10\x0b\".\n\x04Host\x12\x12\n\ngpu_driver\x18\x04 \x01(\t\x12\x12\n\nhypervisor\x18\x05 \x01(\x05\"m\n\x06\x43onfig\x12\x18\n\x10\x65nabled_features\x18\x01 \x03(\x05\x12\x19\n\x11selected_renderer\x18\x02 \x01(\x05\x12\x16\n\x0e\x63pu_core_count\x18\x03 \x01(\x05\x12\x16\n\x0eram_size_bytes\x18\x04 \x01(\x03\"M\n\tSaveStats\x12\x13\n\x0bincremental\x18\x01 \x01(\r\x12\x10\n\x08\x64uration\x18\x02 \x01(\x04\x12\x19\n\x11ram_changed_bytes\x18\x03 \x01(\x04\"\x8d\x04\n\x08Snapshot\x12\x0f\n\x07version\x18\x01 \x01(\x05\x12\x15\n\rcreation_time\x18\x02 \x01(\x03\x12(\n\x06images\x18\x03 \x03(\x0b\x32\x18.emulator_snapshot.Image\x12%\n\x04host\x18\x04 \x01(\x0b\x32\x17.emulator_snapshot.Host\x12)\n\x06\x63onfig\x18\x05 \x01(\x0b\x32\x19.emulator_snapshot.Config\x12\"\n\x1a\x66\x61iled_to_load_reason_code\x18\x07 \x01(\x03\x12$\n\x1cguest_data_partition_mounted\x18\x08 \x01(\x08\x12\x10\n\x08rotation\x18\t \x01(\x05\x12\x15\n\rinvalid_loads\x18\n \x01(\x05\x12\x18\n\x10successful_loads\x18\x0b \x01(\x05\x12\x14\n\x0clogical_name\x18\x0c \x01(\t\x12\x0e\n\x06parent\x18\r \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x0e \x01(\t\x12\x30\n\nsave_stats\x18\x0f \x03(\x0b\x32\x1c.emulator_snapshot.SaveStats\x12\x0e\n\x06\x66olded\x18\x10 \x01(\x08\x12\x19\n\x11launch_parameters\x18\x11 \x03(\t\x12\x19\n\x11\x65mulator_build_id\x18\x12 \x01(\t\x12\x1d\n\x15system_image_build_id\x18\x13 \x01(\tB\x1f\n\x1d\x63om.android.emulator.snapshot')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'android_env.proto.snapshot_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  _globals['DESCRIPTOR']._loaded_options = None
+  _globals['DESCRIPTOR']._serialized_options = b'\n\035com.android.emulator.snapshot'
+  _globals['_IMAGE']._serialized_start=56
+  _globals['_IMAGE']._serialized_end=487
+  _globals['_IMAGE_TYPE']._serialized_start=183
+  _globals['_IMAGE_TYPE']._serialized_end=487
+  _globals['_HOST']._serialized_start=489
+  _globals['_HOST']._serialized_end=535
+  _globals['_CONFIG']._serialized_start=537
+  _globals['_CONFIG']._serialized_end=646
+  _globals['_SAVESTATS']._serialized_start=648
+  _globals['_SAVESTATS']._serialized_end=725
+  _globals['_SNAPSHOT']._serialized_start=728
+  _globals['_SNAPSHOT']._serialized_end=1253
+# @@protoc_insertion_point(module_scope)

android_env/proto/snapshot_pb2.pyi

@@ -0,0 +1,117 @@
+from google.protobuf.internal import containers as _containers
+from google.protobuf.internal import enum_type_wrapper as _enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from typing import ClassVar as _ClassVar, Iterable as _Iterable, Mapping as _Mapping, Optional as _Optional, Union as _Union
+
+DESCRIPTOR: _descriptor.FileDescriptor
+
+class Image(_message.Message):
+    __slots__ = ("type", "path", "present", "size", "modification_time")
+    class Type(int, metaclass=_enum_type_wrapper.EnumTypeWrapper):
+        __slots__ = ()
+        IMAGE_TYPE_UNKNOWN: _ClassVar[Image.Type]
+        IMAGE_TYPE_KERNEL: _ClassVar[Image.Type]
+        IMAGE_TYPE_KERNEL_RANCHU: _ClassVar[Image.Type]
+        IMAGE_TYPE_SYSTEM: _ClassVar[Image.Type]
+        IMAGE_TYPE_SYSTEM_COPY: _ClassVar[Image.Type]
+        IMAGE_TYPE_DATA: _ClassVar[Image.Type]
+        IMAGE_TYPE_DATA_COPY: _ClassVar[Image.Type]
+        IMAGE_TYPE_RAMDISK: _ClassVar[Image.Type]
+        IMAGE_TYPE_SDCARD: _ClassVar[Image.Type]
+        IMAGE_TYPE_CACHE: _ClassVar[Image.Type]
+        IMAGE_TYPE_VENDOR: _ClassVar[Image.Type]
+        IMAGE_TYPE_ENCRYPTION_KEY: _ClassVar[Image.Type]
+    IMAGE_TYPE_UNKNOWN: Image.Type
+    IMAGE_TYPE_KERNEL: Image.Type
+    IMAGE_TYPE_KERNEL_RANCHU: Image.Type
+    IMAGE_TYPE_SYSTEM: Image.Type
+    IMAGE_TYPE_SYSTEM_COPY: Image.Type
+    IMAGE_TYPE_DATA: Image.Type
+    IMAGE_TYPE_DATA_COPY: Image.Type
+    IMAGE_TYPE_RAMDISK: Image.Type
+    IMAGE_TYPE_SDCARD: Image.Type
+    IMAGE_TYPE_CACHE: Image.Type
+    IMAGE_TYPE_VENDOR: Image.Type
+    IMAGE_TYPE_ENCRYPTION_KEY: Image.Type
+    TYPE_FIELD_NUMBER: _ClassVar[int]
+    PATH_FIELD_NUMBER: _ClassVar[int]
+    PRESENT_FIELD_NUMBER: _ClassVar[int]
+    SIZE_FIELD_NUMBER: _ClassVar[int]
+    MODIFICATION_TIME_FIELD_NUMBER: _ClassVar[int]
+    type: Image.Type
+    path: str
+    present: bool
+    size: int
+    modification_time: int
+    def __init__(self, type: _Optional[_Union[Image.Type, str]] = ..., path: _Optional[str] = ..., present: bool = ..., size: _Optional[int] = ..., modification_time: _Optional[int] = ...) -> None: ...
+
+class Host(_message.Message):
+    __slots__ = ("gpu_driver", "hypervisor")
+    GPU_DRIVER_FIELD_NUMBER: _ClassVar[int]
+    HYPERVISOR_FIELD_NUMBER: _ClassVar[int]
+    gpu_driver: str
+    hypervisor: int
+    def __init__(self, gpu_driver: _Optional[str] = ..., hypervisor: _Optional[int] = ...) -> None: ...
+
+class Config(_message.Message):
+    __slots__ = ("enabled_features", "selected_renderer", "cpu_core_count", "ram_size_bytes")
+    ENABLED_FEATURES_FIELD_NUMBER: _ClassVar[int]
+    SELECTED_RENDERER_FIELD_NUMBER: _ClassVar[int]
+    CPU_CORE_COUNT_FIELD_NUMBER: _ClassVar[int]
+    RAM_SIZE_BYTES_FIELD_NUMBER: _ClassVar[int]
+    enabled_features: _containers.RepeatedScalarFieldContainer[int]
+    selected_renderer: int
+    cpu_core_count: int
+    ram_size_bytes: int
+    def __init__(self, enabled_features: _Optional[_Iterable[int]] = ..., selected_renderer: _Optional[int] = ..., cpu_core_count: _Optional[int] = ..., ram_size_bytes: _Optional[int] = ...) -> None: ...
+
+class SaveStats(_message.Message):
+    __slots__ = ("incremental", "duration", "ram_changed_bytes")
+    INCREMENTAL_FIELD_NUMBER: _ClassVar[int]
+    DURATION_FIELD_NUMBER: _ClassVar[int]
+    RAM_CHANGED_BYTES_FIELD_NUMBER: _ClassVar[int]
+    incremental: int
+    duration: int
+    ram_changed_bytes: int
+    def __init__(self, incremental: _Optional[int] = ..., duration: _Optional[int] = ..., ram_changed_bytes: _Optional[int] = ...) -> None: ...
+
+class Snapshot(_message.Message):
+    __slots__ = ("version", "creation_time", "images", "host", "config", "failed_to_load_reason_code", "guest_data_partition_mounted", "rotation", "invalid_loads", "successful_loads", "logical_name", "parent", "description", "save_stats", "folded", "launch_parameters", "emulator_build_id", "system_image_build_id")
+    VERSION_FIELD_NUMBER: _ClassVar[int]
+    CREATION_TIME_FIELD_NUMBER: _ClassVar[int]
+    IMAGES_FIELD_NUMBER: _ClassVar[int]
+    HOST_FIELD_NUMBER: _ClassVar[int]
+    CONFIG_FIELD_NUMBER: _ClassVar[int]
+    FAILED_TO_LOAD_REASON_CODE_FIELD_NUMBER: _ClassVar[int]
+    GUEST_DATA_PARTITION_MOUNTED_FIELD_NUMBER: _ClassVar[int]
+    ROTATION_FIELD_NUMBER: _ClassVar[int]
+    INVALID_LOADS_FIELD_NUMBER: _ClassVar[int]
+    SUCCESSFUL_LOADS_FIELD_NUMBER: _ClassVar[int]
+    LOGICAL_NAME_FIELD_NUMBER: _ClassVar[int]
+    PARENT_FIELD_NUMBER: _ClassVar[int]
+    DESCRIPTION_FIELD_NUMBER: _ClassVar[int]
+    SAVE_STATS_FIELD_NUMBER: _ClassVar[int]
+    FOLDED_FIELD_NUMBER: _ClassVar[int]
+    LAUNCH_PARAMETERS_FIELD_NUMBER: _ClassVar[int]
+    EMULATOR_BUILD_ID_FIELD_NUMBER: _ClassVar[int]
+    SYSTEM_IMAGE_BUILD_ID_FIELD_NUMBER: _ClassVar[int]
+    version: int
+    creation_time: int
+    images: _containers.RepeatedCompositeFieldContainer[Image]
+    host: Host
+    config: Config
+    failed_to_load_reason_code: int
+    guest_data_partition_mounted: bool
+    rotation: int
+    invalid_loads: int
+    successful_loads: int
+    logical_name: str
+    parent: str
+    description: str
+    save_stats: _containers.RepeatedCompositeFieldContainer[SaveStats]
+    folded: bool
+    launch_parameters: _containers.RepeatedScalarFieldContainer[str]
+    emulator_build_id: str
+    system_image_build_id: str
+    def __init__(self, version: _Optional[int] = ..., creation_time: _Optional[int] = ..., images: _Optional[_Iterable[_Union[Image, _Mapping]]] = ..., host: _Optional[_Union[Host, _Mapping]] = ..., config: _Optional[_Union[Config, _Mapping]] = ..., failed_to_load_reason_code: _Optional[int] = ..., guest_data_partition_mounted: bool = ..., rotation: _Optional[int] = ..., invalid_loads: _Optional[int] = ..., successful_loads: _Optional[int] = ..., logical_name: _Optional[str] = ..., parent: _Optional[str] = ..., description: _Optional[str] = ..., save_stats: _Optional[_Iterable[_Union[SaveStats, _Mapping]]] = ..., folded: bool = ..., launch_parameters: _Optional[_Iterable[str]] = ..., emulator_build_id: _Optional[str] = ..., system_image_build_id: _Optional[str] = ...) -> None: ...

android_env/proto/snapshot_pb2_grpc.py

@@ -0,0 +1,24 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+"""Client and server classes corresponding to protobuf-defined services."""
+import grpc
+import warnings
+
+
+GRPC_GENERATED_VERSION = '1.71.0'
+GRPC_VERSION = grpc.__version__
+_version_not_supported = False
+
+try:
+    from grpc._utilities import first_version_is_lower
+    _version_not_supported = first_version_is_lower(GRPC_VERSION, GRPC_GENERATED_VERSION)
+except ImportError:
+    _version_not_supported = True
+
+if _version_not_supported:
+    raise RuntimeError(
+        f'The grpc package installed is at version {GRPC_VERSION},'
+        + f' but the generated code in android_env/proto/snapshot_pb2_grpc.py depends on'
+        + f' grpcio>={GRPC_GENERATED_VERSION}.'
+        + f' Please upgrade your grpc module to grpcio>={GRPC_GENERATED_VERSION}'
+        + f' or downgrade your generated code using grpcio-tools<={GRPC_VERSION}.'
+    )

android_env/proto/snapshot_service.proto

@@ -0,0 +1,289 @@
+// Copyright 2024 DeepMind Technologies Limited.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+// Copyright (C) 2018 The Android Open Source Project
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+// Note that if you add/remove methods in this file you must update
+// the metrics sql as well by running ./android/scripts/gen-grpc-sql.py
+//
+// Please group deleted methods in a block including the date (MM/DD/YY)
+// it was removed. This enables us to easily keep metrics around after removal
+//
+// list of deleted methods
+// rpc iWasDeleted (03/12/12)
+// ...
+syntax = "proto3";
+
+package android.emulation.control;
+
+import "android_env/proto/snapshot.proto";
+
+option java_multiple_files = true;
+option java_package = "com.android.emulator.control";
+option objc_class_prefix = "AEC";
+
+// The SnapshotService enables you to list, insert, store, and retrieve
+// snapshots.
+//
+// Currently there are two types of snapshots:
+//
+// - Local (default): These are snapshots that are created locally. They are
+//     stored internally inside qcow2 files and are very efficient. These are
+//     the snapshots usually created by interacting with the UI.
+//
+// - Remote: These are snapshots that have been exported at a certain point.
+//     an exported snapshot is normalized (completely self contained) and
+//     can be imported into an emulator with a similar hardware configuration.
+//
+// Currently the emulator has limited support for importing snapshots:
+// - Once an imported snapshot has been loaded into an emulator it is no longer
+// possible to create new snapshots.
+// - The hardware configuration of the emulator your are pushing a snapshot to
+// must match (or be very similar) to the one you pulled the snapshot from.
+//
+// For example do not expect to be able to restore a snapshot on created on an
+// Intel cpu on an AMD cpu.
+service SnapshotService {
+  // Lists all the snapshots, filtered by the given query, that are stored
+  // locally for the currently running avd. This includes all the snapshots that
+  // were imported (pushed) into this emulator.
+  //
+  // Returns a list of snapshot_id's and associated details that describes
+  // the hardware configuration, logical name, etc of the snapshot.
+  rpc ListSnapshots(SnapshotFilter) returns (SnapshotList) {}
+
+  // Pulls down the snapshot stored inside the AVD as a tar.gz/tar stream
+  // This will normalize the snapshot, all relevant data to push a snapshot
+  // into a similar emulator will be placed inside the tar file.
+  //
+  // Pulling  down a snapshot will pause the emulator until the snapshots
+  // are rebased and ready for exporting. Once the snapshot is rebased
+  // the emulator will continue and downloading should commence.
+  //
+  // Note that pulling .gz stream is slow.
+  //
+  // You must provide the snapshot_id and (desired) format.
+  //
+  // If SnapshotPackage.path is set, the gRPC service will directly write the
+  // exported snapshot to SnapshotPackage.path without streaming, which is
+  // usually significantly faster. It would require emulator to have direct
+  // access to SnapshotPackage.path, which usually means it can only be used
+  // when pulling from a local emulator.
+  rpc PullSnapshot(SnapshotPackage) returns (stream SnapshotPackage) {}
+
+  // Push a tar.gz stream contain the snapshot. The tar file should
+  // be a snapshot that was exported through the PullSnapshot in the past.
+  // The emulator will try to import the snapshot. The hardware configuration
+  // of the current emulator should match the one used for pulling.
+  //
+  // A detailed description of the snapshot (emulator_snapshot.Snapshot)
+  // is stored in the snapshot.pb file inside the tar.
+  //
+  // You must provide the snapshot_id and format in the first message.
+  // Will return success and a possible error message when a failure occurs.
+  //
+  // If SnapshotPackage.path is set, the gRPC service will directly unzip the
+  // exported snapshot from SnapshotPackage.path without streaming, which is
+  // usually significantly faster. It would require emulator to have direct
+  // access to SnapshotPackage.path, which usually means it can only be used
+  // when pushing to a local emulator.
+  rpc PushSnapshot(stream SnapshotPackage) returns (SnapshotPackage) {}
+
+  // Loads the given snapshot inside the emulator and activates it.
+  // The device will be in the state as it was when the snapshot was created.
+  //
+  // You will no longer be able to call Save if this was an imported
+  // snapshot that was pushed into this emulator.
+  //
+  // You must provide the snapshot_id to indicate which snapshot to load
+  // Will return success and a possible error message when a failure occurs.
+  rpc LoadSnapshot(SnapshotPackage) returns (SnapshotPackage) {}
+
+  // Creates as a snapshot of the current state of the emulator.
+  // You can only save a snapshot if you never activated (Load) an imported
+  // snapshot (Push).
+  //
+  // For example:
+  // - PushSnapshot("some_snap.tar.gz");
+  // - LoadSnapshot("some_snap");
+  // - SaveSnapshot("same_newer_snap"); // <--- Will currently fail.
+  //
+  // You can provide the snapshot_id to indicate the name used for storing.
+  // Will return success and a possible error message when a failure occurs.
+  rpc SaveSnapshot(SnapshotPackage) returns (SnapshotPackage) {}
+
+  // Deletes the snapshot with the given snapshot_id from the avd.
+  //
+  // You must provide the snapshot_id to indicate which snapshot to delete.
+  // Will return success and a possible error message when a failure occurs.
+  rpc DeleteSnapshot(SnapshotPackage) returns (SnapshotPackage) {}
+
+  // Tracks the given process for automated snapshot creation in case of
+  // assert failures.
+  //
+  // Will return success and a possible error message when a failure occurs.
+  // The snapshot_id field will contain the name of the snapshot that
+  // will be created. The pid field will contain the process id that is
+  // being tracked.
+  rpc TrackProcess(IceboxTarget) returns (IceboxTarget) {}
+}
+
+// Sets options for SnapshotService. Used for both request and response
+// messages.
+message SnapshotPackage {
+  enum Format {
+    TARGZ = 0;
+    TAR = 1;
+    DIRECTORY = 2;
+  }
+  // The identifier to the snapshot, only required for request messages. For
+  // streaming service, only used in the first stream message of a gRPC call
+  // (would be ignored in consequent stream messages of the same call).
+  string snapshot_id = 1;
+
+  // A stream of bytes. Encoded as a tar (possibly gzipped) file pendinf on the
+  // value of format.
+  bytes payload = 2;
+
+  // [response only] status fields, usually indicates end of transmission.
+  bool success = 3;
+  bytes err = 4;
+
+  // [request only] Format of the payload. Only used in request messages. For
+  // streaming service, only used in the first stream message of a gRPC call
+  // (would be ignored in consequent stream messages of the same call).
+  Format format = 5;
+
+  // [request only] Path to the snapshot package file. Only used in request
+  // messages.
+  //
+  // When set in a request, the PullSnapshot/PushSnapshot operation will
+  // directly write/read the exported snapshot in path without streaming, which
+  // is usually significantly faster. It would require emulator to have direct
+  // access to path, which usually means it can only be used with a local
+  // emulator.
+  string path = 6;
+}
+
+// A snapshot filter can be used to filter the results produced by ListSnapshots
+message SnapshotFilter {
+  enum LoadStatus {
+    // Only return compatible snapshots
+    CompatibleOnly = 0;
+
+    // Return all snapshots.
+    All = 1;
+  }
+
+  // Filter snapshots by load status.
+  LoadStatus statusFilter = 1;
+}
+
+// Provides detailed information regarding the snapshot.
+message SnapshotDetails {
+  enum LoadStatus {
+    // The emulator believes that the snapshot is compatible with the emulator
+    // that provided this information.  The emulator will attempt to load this
+    // snapshot when requested.
+    //
+    // A snapshot is usually compatible when the following statements are true:
+    // - The snapshot was taken by the current emulator version. i.e.
+    //   emulator_build_id in the details field matches the build_id of the
+    //   emulator that provided this information.
+    //
+    // - The snapshot was taken on the current running machine, and no hardware
+    //  changes have taken place between taking and loading the snapshot.
+    //
+    // - The avd configuration has not changed between when this snapshot was
+    //   taken  and when the snapshot was loaded.
+    //
+    // - The system images on which the avd is based have not changed.
+    Compatible = 0;
+
+    // The emulator will not allow loading of the snapshot, as it deems the
+    // snapshot to be incompatible. Loading of snapshots can be forced by
+    // launching the emulator with the feature "AllowSnapshotMigration" enabled.
+    Incompatible = 1;
+
+    // This snapshot was successfully loaded in the emulator, and was used at
+    // the starting point of the current running emulator. The following holds:
+    //
+    // A loaded snapshot is a compatible snapshot
+    // There is at most one snapshot_id that is in the "Loaded" state
+    Loaded = 2;
+  }
+
+  // The id of this snapshot. Use this id to load/delete/pull the
+  // snapshot.
+  string snapshot_id = 1;
+
+  // Detailed information about this snapshot. This contains a detailed
+  // hardware description of the snapshot. These details are the same
+  // as the "snapshot.pb" file found in an exported snapshot.
+  // Look at the import file for a detailed description of the available
+  // fields.
+  emulator_snapshot.Snapshot details = 2;
+
+  // Provides information about the ability to restore this snapshot.
+  LoadStatus status = 3;
+
+  // The size of the folder that stores required information to load a snapshot.
+  uint64 size = 4;
+}
+
+// A list of on snapshot details.
+message SnapshotList {
+  repeated SnapshotDetails snapshots = 1;
+}
+
+message IceboxTarget {
+  // This is the process id to attach to, if this value is not set (0)
+  // The process name will be used instead.
+  int64 pid = 1;
+
+  // The process name to attach to if any, if this is not set the pid will
+  // be used. This is usually the application name of your application under
+  // test, that is passed in to the am instrument command. It is likely
+  // what you will find in your AndroidManifest.xml
+  string package_name = 2;
+
+  // The name of the snapshot that icebox will create if a snapshot is
+  // generated.
+  string snapshot_id = 3;
+
+  // [Output Only] True if icebox failed to track the given target.
+  bool failed = 4;
+
+  // [Output Only] Detailed error message that might provide more information.
+  string err = 5;
+
+  // Maximum number of snapshots the emulator can take during one Icebox run.
+  // Set to -1 for unlimited number of snapshots.
+  int32 max_snapshot_number = 6;
+}
+
+// list of deleted methods:
+//