release-parser/proto/release.proto

// 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.

// [START declaration]
syntax = "proto3";
package com_android_cts_releaseparser;
// [END declaration]

// [START java_declaration]
option java_package = "com.android.cts.releaseparser";
option java_outer_classname = "ReleaseProto";
// [END java_declaration]

// [START messages]
message Option {
    string name = 1;
    string key = 2;
    string value =3;
}

message TestModuleConfig {
    string module_name = 1;
    string component = 2;
    string description = 3;
    repeated Option options = 4;

    message TargetPreparer {
        string test_class = 1;
        repeated Option options = 2;
    }
    repeated TargetPreparer target_preparers = 5;
    repeated string test_file_names = 6;

    message TestClass {
        string test_class = 1;
        string package = 2;
        repeated Option options = 3;
    }
    repeated TestClass test_classes = 7;
    repeated string test_jars = 8;
}

message Element {
    string name = 1;
    string value = 2;
}

message ApiAnnotation {
    int32 visibility = 1;
    string type = 2;

    repeated Element elements = 3;
}

message ApiField {
    string defining_class = 1;
    string name = 2;
    string type = 3;
    int32 access_flags = 4;
    string initial_value = 5;
    repeated ApiAnnotation annotations = 6;
    string value = 7;
}

message ApiMethod {
    string defining_class = 1;
    string name = 2;
    repeated string parameters = 3;
    string return_type = 4;
    int32 access_flags = 5;
    string known_failure_filter = 6;
    repeated ApiAnnotation annotations = 7;
}

message ApiClass {
    string name = 1;
    string type = 2;
    string super_class = 3;
    repeated string interfaces = 4;
    TestClassType test_class_type = 5;
    int32 access_flags = 6;
    repeated ApiAnnotation annotations = 7;
    repeated ApiMethod methods = 8;
    repeated ApiField fields = 9;
}

message ApiPackage {
    string name = 1;
    string package_file = 2;
    string content_id = 3;
    string op_codes = 4;

    repeated ApiClass classes = 5;
    string error = 6;
}

enum TestClassType {
    UNKNOWN = 0;
    JUNIT3 = 1;
    JUNIT4 = 2;
    PARAMETERIZED = 3;
    JAVAHOST = 4;
}

message TestSuite {
    string name = 1;
    // Version
    string version = 2;
    // Build Number
    string build_number = 3;
    // Content ID
    string content_id = 4;

    enum TestType {
        UNKNOWN = 0;
        ANDROIDJUNIT = 1;
        JAVAHOST = 2;
        GTEST = 3;
        LIBCORE = 4;
        DALVIK = 5;
        DEQP = 6;
    }

    message Module {
        string name = 1;
        string config_file = 2;
        TestType test_type = 3;
        string test_class = 4;
        repeated ApiPackage packages = 5;
    }
    repeated Module modules = 5;
}

message Service {
    string name = 1;
    string file = 2;
    repeated string arguments = 3;
    string clazz = 4;
    string user = 5;
    string group = 6;
    string writepid = 7;
    repeated string options = 8;
}

message Api {
    string name = 1;
    string version = 2;
    // map of Package Name & Package Message
    map<string, ApiPackage> packages = 3;
}

message UsesFeature {
    string name = 1;
    string required = 2;
}

message UsesLibrary {
    string name = 1;
    string required = 2;
}

message AppInfo {
    string package_name = 1;
    string version_code = 2;
    string version_name = 3;
    string sdk_version = 4;
    string target_sdk_version = 5;
    repeated UsesFeature uses_features = 6;
    repeated UsesLibrary uses_libraries = 7;
    repeated string native_code = 8;
    repeated string uses_permissions = 9;
    repeated string activities = 10;
    repeated string services = 11;
    repeated string providers = 12;
    map<string, string> properties = 13;
    repeated ApiPackage external_api_packages = 14;
    repeated ApiPackage internal_api_packages = 15;
    PackageFileContent package_file_content = 16;
    string package_signature = 17;
}

message ImageSection {
    uint32 offset = 1;
    uint32 size = 2;
}

// art/runtime/image.h
message ArtInfo {
    bool valid = 1;
    // skip magic_[4]
    string version = 2;
    uint32 image_begin = 3;
    uint32 image_size = 4;
    uint32 oat_checksum = 5;
    uint32 oat_file_begin = 6;
    uint32 oat_data_begin = 7;
    uint32 oat_data_end = 8;
    uint32 oat_file_end = 9;

    // app image headers only
    uint32 boot_image_begin = 10;
    uint32 boot_image_size = 11;
    uint32 boot_oat_begin = 12;
    uint32 boot_oat_size = 13;

    int32 patch_delta = 14;
    uint32 image_roots = 15;
    uint32 pointer_size = 16;
    uint32 compile_pic = 17;
    uint32 is_pic = 18;

    repeated ImageSection image_sections = 19;
    repeated uint64 image_methods = 20;

    uint32 storage_mode = 21;
    uint32 data_size = 22;
}

// art/dex2oat/linker/oat_writer.cc OatDexFile
message OatDexInfo {
    string dex_file_location_data = 1;
    // The checksum of the dex file.
    uint32 dex_file_location_checksum = 2;
    // Offset of the dex file in the vdex file.
    uint32 dex_file_offset = 3;
    // The lookup table offset in the oat file. Set in WriteTypeLookupTables.
    uint32 lookup_table_offset = 4;
    // Class and BSS offsets set in PrepareLayout.
    uint32 class_offsets_offset = 5;
    uint32 method_bss_mapping_offset = 6;
    uint32 type_bss_mapping_offset = 7;
    uint32 string_bss_mapping_offset = 8;
    // Offset of dex sections that will have different runtime madvise states.
    uint32 dex_sections_layout_offset = 9;
}

// art/runtime/oat.h
message OatInfo {
    // skip magic_[4]
    string version = 1;
    uint32 adler32_checksum = 2;
    // art/libartbase/arch/instruction_set.h

    uint32 instruction_set = 3;
    uint32 instruction_set_features_bitmap = 4;
    uint32 dex_file_count = 5;
    uint32 oat_dex_files_offset = 6;
    uint32 executable_offset = 7;
    uint32 interpreter_to_interpreter_bridge_offset = 8;
    uint32 interpreter_to_compiled_code_bridge_offset = 9;
    uint32 jni_dlsym_lookup_offset = 10;
    uint32 quick_generic_jni_trampoline_offset = 11;
    uint32 quick_imt_conflict_trampoline_offset = 12;
    uint32 quick_resolution_trampoline_offset = 13;
    uint32 quick_to_interpreter_bridge_offset = 14;

    // for backward compatibility, removed from version 162, see aosp/e0669326c0282b5b645aba75160425eef9d57617
    uint32 image_patch_delta = 15;

    uint32 image_file_location_oat_checksum = 16;
    // for backward compatibility, removed from version 162, see aosp/e0669326c0282b5b645aba75160425eef9d57617
    uint32 image_file_location_oat_data_begin = 17;

    uint32 key_value_store_size = 18;

    // int8_t key_value_store_[0];
    map<string, string> key_value_store = 19;
    repeated OatDexInfo oat_dex_info = 20;
    bool valid = 21;
    int32 bits = 22;
    string architecture = 23;
}

message DexSectionHeader {
    uint32 dex_size = 1;
    uint32 dex_shared_data_size = 2;
    uint32 quickening_info_size = 3;
}

// art/runtime/vdex_file.h
message VdexInfo {
    bool valid = 1;

    // skip magic_[4]
    string verifier_deps_version = 2;
    string dex_section_version = 3;
    uint32 number_of_dex_files = 4;
    uint32 verifier_deps_size = 5;
    repeated uint32 checksums = 6;
    repeated DexSectionHeader dex_section_headers = 7;
}

message Permission {
    string name = 1;
    repeated Element elements = 2;
}

message PermissionList {
    string name = 1;
    repeated Permission permissions = 2;
}

message PackageFileContent {
    map<string, Entry> entries = 1;
}

// An entry in a release
message Entry {
    // Name
    string name = 1;

    enum EntryType {
        FOLDER = 0;
        FILE = 1;
        TEST_MODULE_CONFIG = 2;
        JAR = 3;
        APK = 4;
        EXE = 5;
        SO = 6;
        OAT = 7;
        ODEX = 8;
        VDEX = 9;
        TEST_SUITE_TRADEFED = 10;
        BUILD_PROP = 11;
        SYMBOLIC_LINK = 12;
        RC = 13;
        ART = 14;
        XML = 15;
        IMG = 16;
    }
    // Type
    EntryType type = 2;

    // Size
    int64 size = 3;
    // Content ID
    string content_id = 4;
    // code_id
    string code_id = 5;
    // Parent folder
    string abi_architecture = 6;
    int32 abi_bits = 7;
    string parent_folder = 8;
    // Relative path
    string relative_path = 9;

    repeated string dependencies = 10;
    repeated string dynamic_loading_dependencies = 11;

    // file type specified info
    AppInfo app_info = 12;
    ArtInfo art_info = 13;
    OatInfo oat_info = 14;
    VdexInfo vdex_info = 15;
    // TestModule.config message
    TestModuleConfig test_module_config = 16;
    // Native services
    repeated Service services = 17;
    // Device permissions
    map<string, PermissionList> device_permissions = 18;
    // property map(key,value)
    map<string, string> properties = 19;
}

enum ReleaseType {
    DEVICE_BUILD = 0;
    TEST_SUITE = 1;
    APP_DISTRIBUTION_PACKAGE = 2;
}

message ReleaseContent {
    // Name
    string name = 1;
    // Version
    string version = 2;
    // Build Number
    string build_number = 3;
    // Full name
    string fullname = 4;
    // release uid e.g. Build Fingerprint
    string release_id = 5;
    // Content id
    string content_id = 6;
    // Size in byte
    int64 size = 7;
    ReleaseType release_type = 8;
    // property map(key,value)
    map<string, string> properties = 9;
    // File Entry map(relative_path, entry)
    map<string, Entry> entries = 10;

    // Test Suite specific
    string test_suite_tradefed = 11;
    string target_arch = 12;
    repeated string known_failures = 13;
}
// [END messages]