Adam Lesinski | 59e04c6 | 2016-02-04 15:59:23 -0800 | [diff] [blame] | 1 | /* |
| 2 | * Copyright (C) 2016 The Android Open Source Project |
| 3 | * |
| 4 | * Licensed under the Apache License, Version 2.0 (the "License"); |
| 5 | * you may not use this file except in compliance with the License. |
| 6 | * You may obtain a copy of the License at |
| 7 | * |
| 8 | * http://www.apache.org/licenses/LICENSE-2.0 |
| 9 | * |
| 10 | * Unless required by applicable law or agreed to in writing, software |
| 11 | * distributed under the License is distributed on an "AS IS" BASIS, |
| 12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| 13 | * See the License for the specific language governing permissions and |
| 14 | * limitations under the License. |
| 15 | */ |
| 16 | |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 17 | syntax = "proto3"; |
| 18 | |
Adam Lesinski | b58c3ef | 2017-09-12 17:39:52 -0700 | [diff] [blame] | 19 | import "frameworks/base/tools/aapt2/Configuration.proto"; |
| 20 | |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 21 | package aapt.pb; |
Adam Lesinski | 59e04c6 | 2016-02-04 15:59:23 -0800 | [diff] [blame] | 22 | |
Adam Lesinski | 4ffea04 | 2017-08-10 15:37:28 -0700 | [diff] [blame] | 23 | option java_package = "com.android.aapt"; |
Adam Lesinski | 59e04c6 | 2016-02-04 15:59:23 -0800 | [diff] [blame] | 24 | option optimize_for = LITE_RUNTIME; |
| 25 | |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 26 | // A string pool that wraps the binary form of the C++ class android::ResStringPool. |
Adam Lesinski | 59e04c6 | 2016-02-04 15:59:23 -0800 | [diff] [blame] | 27 | message StringPool { |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 28 | bytes data = 1; |
Adam Lesinski | 59e04c6 | 2016-02-04 15:59:23 -0800 | [diff] [blame] | 29 | } |
| 30 | |
Adam Lesinski | 4ffea04 | 2017-08-10 15:37:28 -0700 | [diff] [blame] | 31 | // The position of a declared entity within a file. |
| 32 | message SourcePosition { |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 33 | uint32 line_number = 1; |
| 34 | uint32 column_number = 2; |
Adam Lesinski | 4ffea04 | 2017-08-10 15:37:28 -0700 | [diff] [blame] | 35 | } |
| 36 | |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 37 | // Developer friendly source file information for an entity in the resource table. |
Adam Lesinski | 59e04c6 | 2016-02-04 15:59:23 -0800 | [diff] [blame] | 38 | message Source { |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 39 | // The index of the string path within the source string pool of a ResourceTable. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 40 | uint32 path_idx = 1; |
| 41 | SourcePosition position = 2; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 42 | } |
| 43 | |
| 44 | // Top level message representing a resource table. |
| 45 | message ResourceTable { |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 46 | // The string pool containing source paths referenced throughout the resource table. This does |
| 47 | // not end up in the final binary ARSC file. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 48 | StringPool source_pool = 1; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 49 | |
| 50 | // Resource definitions corresponding to an Android package. |
Adam Lesinski | 4ffea04 | 2017-08-10 15:37:28 -0700 | [diff] [blame] | 51 | repeated Package package = 2; |
Ryan Mitchell | 54237ff | 2018-12-13 15:44:29 -0800 | [diff] [blame] | 52 | |
| 53 | // The <overlayable> declarations within the resource table. |
| 54 | repeated Overlayable overlayable = 3; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 55 | } |
| 56 | |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 57 | // A package ID in the range [0x00, 0xff]. |
| 58 | message PackageId { |
| 59 | uint32 id = 1; |
| 60 | } |
| 61 | |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 62 | // Defines resources for an Android package. |
| 63 | message Package { |
| 64 | // The package ID of this package, in the range [0x00, 0xff]. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 65 | // - ID 0x00 is reserved for shared libraries, or when the ID is assigned at run-time. |
| 66 | // - ID 0x01 is reserved for the 'android' package (framework). |
| 67 | // - ID range [0x02, 0x7f) is reserved for auto-assignment to shared libraries at run-time. |
| 68 | // - ID 0x7f is reserved for the application package. |
| 69 | // - IDs > 0x7f are reserved for the application as well and are treated as feature splits. |
| 70 | // This may not be set if no ID was assigned. |
| 71 | PackageId package_id = 1; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 72 | |
| 73 | // The Java compatible Android package name of the app. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 74 | string package_name = 2; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 75 | |
| 76 | // The series of types defined by the package. |
Adam Lesinski | 4ffea04 | 2017-08-10 15:37:28 -0700 | [diff] [blame] | 77 | repeated Type type = 3; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 78 | } |
| 79 | |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 80 | // A type ID in the range [0x01, 0xff]. |
| 81 | message TypeId { |
| 82 | uint32 id = 1; |
| 83 | } |
| 84 | |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 85 | // A set of resources grouped under a common type. Such types include string, layout, xml, dimen, |
| 86 | // attr, etc. This maps to the second part of a resource identifier in Java (R.type.entry). |
| 87 | message Type { |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 88 | // The ID of the type. This may not be set if no ID was assigned. |
| 89 | TypeId type_id = 1; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 90 | |
| 91 | // The name of the type. This corresponds to the 'type' part of a full resource name of the form |
| 92 | // package:type/entry. The set of legal type names is listed in Resource.cpp. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 93 | string name = 2; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 94 | |
| 95 | // The entries defined for this type. |
Adam Lesinski | 4ffea04 | 2017-08-10 15:37:28 -0700 | [diff] [blame] | 96 | repeated Entry entry = 3; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 97 | } |
| 98 | |
Adam Lesinski | 71be705 | 2017-12-12 16:48:07 -0800 | [diff] [blame] | 99 | // The Visibility of a symbol/entry (public, private, undefined). |
| 100 | message Visibility { |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 101 | // The visibility of the resource outside of its package. |
Adam Lesinski | 71be705 | 2017-12-12 16:48:07 -0800 | [diff] [blame] | 102 | enum Level { |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 103 | // No visibility was explicitly specified. This is typically treated as private. |
| 104 | // The distinction is important when two separate R.java files are generated: a public and |
| 105 | // private one. An unknown visibility, in this case, would cause the resource to be omitted |
| 106 | // from either R.java. |
Adam Lesinski | 4ffea04 | 2017-08-10 15:37:28 -0700 | [diff] [blame] | 107 | UNKNOWN = 0; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 108 | |
| 109 | // A resource was explicitly marked as private. This means the resource can not be accessed |
| 110 | // outside of its package unless the @*package:type/entry notation is used (the asterisk being |
| 111 | // the private accessor). If two R.java files are generated (private + public), the resource |
| 112 | // will only be emitted to the private R.java file. |
Adam Lesinski | 4ffea04 | 2017-08-10 15:37:28 -0700 | [diff] [blame] | 113 | PRIVATE = 1; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 114 | |
| 115 | // A resource was explicitly marked as public. This means the resource can be accessed |
| 116 | // from any package, and is emitted into all R.java files, public and private. |
Adam Lesinski | 4ffea04 | 2017-08-10 15:37:28 -0700 | [diff] [blame] | 117 | PUBLIC = 2; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 118 | } |
| 119 | |
Adam Lesinski | 71be705 | 2017-12-12 16:48:07 -0800 | [diff] [blame] | 120 | Level level = 1; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 121 | |
| 122 | // The path at which this entry's visibility was defined (eg. public.xml). |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 123 | Source source = 2; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 124 | |
| 125 | // The comment associated with the <public> tag. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 126 | string comment = 3; |
Adam Lesinski | 71be705 | 2017-12-12 16:48:07 -0800 | [diff] [blame] | 127 | } |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 128 | |
Adam Lesinski | 71be705 | 2017-12-12 16:48:07 -0800 | [diff] [blame] | 129 | // Whether a resource comes from a compile-time overlay and is explicitly allowed to not overlay an |
| 130 | // existing resource. |
| 131 | message AllowNew { |
| 132 | // Where this was defined in source. |
| 133 | Source source = 1; |
| 134 | |
| 135 | // Any comment associated with the declaration. |
| 136 | string comment = 2; |
| 137 | } |
| 138 | |
Ryan Mitchell | 54237ff | 2018-12-13 15:44:29 -0800 | [diff] [blame] | 139 | // Represents a set of overlayable resources. |
Adam Lesinski | 71be705 | 2017-12-12 16:48:07 -0800 | [diff] [blame] | 140 | message Overlayable { |
Ryan Mitchell | 54237ff | 2018-12-13 15:44:29 -0800 | [diff] [blame] | 141 | // The name of the <overlyabale>. |
| 142 | string name = 1; |
| 143 | |
| 144 | // The location of the <overlyabale> declaration in the source. |
| 145 | Source source = 2; |
| 146 | |
| 147 | // The component responsible for enabling and disabling overlays targeting this <overlayable>. |
| 148 | string actor = 3; |
| 149 | } |
| 150 | |
| 151 | // Represents an overlayable <item> declaration within an <overlayable> tag. |
| 152 | message OverlayableItem { |
Ryan Mitchell | e4e989c | 2018-10-29 02:21:50 -0700 | [diff] [blame] | 153 | enum Policy { |
Ryan Mitchell | 1bb1fe0 | 2018-11-16 11:21:41 -0800 | [diff] [blame] | 154 | PUBLIC = 0; |
| 155 | SYSTEM = 1; |
| 156 | VENDOR = 2; |
| 157 | PRODUCT = 3; |
Ryan Mitchell | e4e989c | 2018-10-29 02:21:50 -0700 | [diff] [blame] | 158 | } |
| 159 | |
Ryan Mitchell | 54237ff | 2018-12-13 15:44:29 -0800 | [diff] [blame] | 160 | // The location of the <item> declaration in source. |
Adam Lesinski | 71be705 | 2017-12-12 16:48:07 -0800 | [diff] [blame] | 161 | Source source = 1; |
| 162 | |
| 163 | // Any comment associated with the declaration. |
| 164 | string comment = 2; |
Ryan Mitchell | e4e989c | 2018-10-29 02:21:50 -0700 | [diff] [blame] | 165 | |
Ryan Mitchell | 54237ff | 2018-12-13 15:44:29 -0800 | [diff] [blame] | 166 | // The policy defined by the enclosing <policy> tag of this <item>. |
Ryan Mitchell | 1bb1fe0 | 2018-11-16 11:21:41 -0800 | [diff] [blame] | 167 | repeated Policy policy = 3; |
Ryan Mitchell | 54237ff | 2018-12-13 15:44:29 -0800 | [diff] [blame] | 168 | |
| 169 | // The index into overlayable list that points to the <overlayable> tag that contains |
| 170 | // this <item>. |
| 171 | uint32 overlayable_idx = 4; |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 172 | } |
| 173 | |
| 174 | // An entry ID in the range [0x0000, 0xffff]. |
| 175 | message EntryId { |
| 176 | uint32 id = 1; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 177 | } |
| 178 | |
| 179 | // An entry declaration. An entry has a full resource ID that is the combination of package ID, |
| 180 | // type ID, and its own entry ID. An entry on its own has no value, but values are defined for |
| 181 | // various configurations/variants. |
| 182 | message Entry { |
| 183 | // The ID of this entry. Together with the package ID and type ID, this forms a full resource ID |
| 184 | // of the form 0xPPTTEEEE, where PP is the package ID, TT is the type ID, and EEEE is the entry |
| 185 | // ID. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 186 | // This may not be set if no ID was assigned. |
| 187 | EntryId entry_id = 1; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 188 | |
| 189 | // The name of this entry. This corresponds to the 'entry' part of a full resource name of the |
| 190 | // form package:type/entry. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 191 | string name = 2; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 192 | |
Adam Lesinski | 71be705 | 2017-12-12 16:48:07 -0800 | [diff] [blame] | 193 | // The visibility of this entry (public, private, undefined). |
| 194 | Visibility visibility = 3; |
| 195 | |
| 196 | // Whether this resource, when originating from a compile-time overlay, is allowed to NOT overlay |
| 197 | // any existing resources. |
| 198 | AllowNew allow_new = 4; |
| 199 | |
| 200 | // Whether this resource can be overlaid by a runtime resource overlay (RRO). |
Ryan Mitchell | 54237ff | 2018-12-13 15:44:29 -0800 | [diff] [blame] | 201 | OverlayableItem overlayable_item = 5; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 202 | |
| 203 | // The set of values defined for this entry, each corresponding to a different |
| 204 | // configuration/variant. |
Adam Lesinski | 71be705 | 2017-12-12 16:48:07 -0800 | [diff] [blame] | 205 | repeated ConfigValue config_value = 6; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 206 | } |
| 207 | |
| 208 | // A Configuration/Value pair. |
| 209 | message ConfigValue { |
Adam Lesinski | b58c3ef | 2017-09-12 17:39:52 -0700 | [diff] [blame] | 210 | Configuration config = 1; |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 211 | Value value = 2; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 212 | } |
| 213 | |
| 214 | // The generic meta-data for every value in a resource table. |
| 215 | message Value { |
| 216 | // Where the value was defined. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 217 | Source source = 1; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 218 | |
| 219 | // Any comment associated with the value. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 220 | string comment = 2; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 221 | |
| 222 | // Whether the value can be overridden. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 223 | bool weak = 3; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 224 | |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 225 | // The value is either an Item or a CompoundValue. |
| 226 | oneof value { |
| 227 | Item item = 4; |
| 228 | CompoundValue compound_value = 5; |
| 229 | } |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 230 | } |
| 231 | |
| 232 | // An Item is an abstract type. It represents a value that can appear inline in many places, such |
| 233 | // as XML attribute values or on the right hand side of style attribute definitions. The concrete |
| 234 | // type is one of the types below. Only one can be set. |
| 235 | message Item { |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 236 | oneof value { |
| 237 | Reference ref = 1; |
| 238 | String str = 2; |
| 239 | RawString raw_str = 3; |
| 240 | StyledString styled_str = 4; |
| 241 | FileReference file = 5; |
| 242 | Id id = 6; |
| 243 | Primitive prim = 7; |
| 244 | } |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 245 | } |
| 246 | |
| 247 | // A CompoundValue is an abstract type. It represents a value that is a made of other values. |
| 248 | // These can only usually appear as top-level resources. The concrete type is one of the types |
| 249 | // below. Only one can be set. |
| 250 | message CompoundValue { |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 251 | oneof value { |
| 252 | Attribute attr = 1; |
| 253 | Style style = 2; |
| 254 | Styleable styleable = 3; |
| 255 | Array array = 4; |
| 256 | Plural plural = 5; |
| 257 | } |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 258 | } |
| 259 | |
| 260 | // A value that is a reference to another resource. This reference can be by name or resource ID. |
Adam Lesinski | 59e04c6 | 2016-02-04 15:59:23 -0800 | [diff] [blame] | 261 | message Reference { |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 262 | enum Type { |
| 263 | // A plain reference (@package:type/entry). |
Adam Lesinski | 4ffea04 | 2017-08-10 15:37:28 -0700 | [diff] [blame] | 264 | REFERENCE = 0; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 265 | |
| 266 | // A reference to a theme attribute (?package:type/entry). |
Adam Lesinski | 4ffea04 | 2017-08-10 15:37:28 -0700 | [diff] [blame] | 267 | ATTRIBUTE = 1; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 268 | } |
| 269 | |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 270 | Type type = 1; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 271 | |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 272 | // The resource ID (0xPPTTEEEE) of the resource being referred. This is optional. |
| 273 | uint32 id = 2; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 274 | |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 275 | // The name of the resource being referred. This is optional if the resource ID is set. |
| 276 | string name = 3; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 277 | |
| 278 | // Whether this reference is referencing a private resource (@*package:type/entry). |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 279 | bool private = 4; |
Adam Lesinski | 59e04c6 | 2016-02-04 15:59:23 -0800 | [diff] [blame] | 280 | } |
| 281 | |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 282 | // A value that represents an ID. This is just a placeholder, as ID values are used to occupy a |
| 283 | // resource ID (0xPPTTEEEE) as a unique identifier. Their value is unimportant. |
Adam Lesinski | 59e04c6 | 2016-02-04 15:59:23 -0800 | [diff] [blame] | 284 | message Id { |
| 285 | } |
| 286 | |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 287 | // A value that is a string. |
Adam Lesinski | 59e04c6 | 2016-02-04 15:59:23 -0800 | [diff] [blame] | 288 | message String { |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 289 | string value = 1; |
Adam Lesinski | 59e04c6 | 2016-02-04 15:59:23 -0800 | [diff] [blame] | 290 | } |
| 291 | |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 292 | // A value that is a raw string, which is unescaped/uninterpreted. This is typically used to |
| 293 | // represent the value of a style attribute before the attribute is compiled and the set of |
| 294 | // allowed values is known. |
Adam Lesinski | 59e04c6 | 2016-02-04 15:59:23 -0800 | [diff] [blame] | 295 | message RawString { |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 296 | string value = 1; |
Adam Lesinski | 0853500 | 2017-08-04 16:15:17 -0700 | [diff] [blame] | 297 | } |
| 298 | |
| 299 | // A string with styling information, like html tags that specify boldness, italics, etc. |
| 300 | message StyledString { |
| 301 | // The raw text of the string. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 302 | string value = 1; |
Adam Lesinski | 0853500 | 2017-08-04 16:15:17 -0700 | [diff] [blame] | 303 | |
| 304 | // A Span marks a region of the string text that is styled. |
| 305 | message Span { |
| 306 | // The name of the tag, and its attributes, encoded as follows: |
| 307 | // tag_name;attr1=value1;attr2=value2;[...] |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 308 | string tag = 1; |
Adam Lesinski | 0853500 | 2017-08-04 16:15:17 -0700 | [diff] [blame] | 309 | |
| 310 | // The first character position this span applies to, in UTF-16 offset. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 311 | uint32 first_char = 2; |
Adam Lesinski | 0853500 | 2017-08-04 16:15:17 -0700 | [diff] [blame] | 312 | |
| 313 | // The last character position this span applies to, in UTF-16 offset. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 314 | uint32 last_char = 3; |
Adam Lesinski | 0853500 | 2017-08-04 16:15:17 -0700 | [diff] [blame] | 315 | } |
| 316 | |
| 317 | repeated Span span = 2; |
Adam Lesinski | 59e04c6 | 2016-02-04 15:59:23 -0800 | [diff] [blame] | 318 | } |
| 319 | |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 320 | // A value that is a reference to an external entity, like an XML file or a PNG. |
Adam Lesinski | 59e04c6 | 2016-02-04 15:59:23 -0800 | [diff] [blame] | 321 | message FileReference { |
Adam Lesinski | e59f0d8 | 2017-10-13 09:36:53 -0700 | [diff] [blame] | 322 | enum Type { |
| 323 | UNKNOWN = 0; |
| 324 | PNG = 1; |
| 325 | BINARY_XML = 2; |
| 326 | PROTO_XML = 3; |
| 327 | } |
| 328 | |
Adam Lesinski | 0853500 | 2017-08-04 16:15:17 -0700 | [diff] [blame] | 329 | // Path to a file within the APK (typically res/type-config/entry.ext). |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 330 | string path = 1; |
Adam Lesinski | e59f0d8 | 2017-10-13 09:36:53 -0700 | [diff] [blame] | 331 | |
| 332 | // The type of file this path points to. For UAM bundle, this cannot be |
| 333 | // BINARY_XML. |
| 334 | Type type = 2; |
Adam Lesinski | 59e04c6 | 2016-02-04 15:59:23 -0800 | [diff] [blame] | 335 | } |
| 336 | |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 337 | // A value that represents a primitive data type (float, int, boolean, etc.). |
Michael Wachenschwanz | 8b74927 | 2018-04-18 18:52:47 -0700 | [diff] [blame] | 338 | // Refer to Res_value in ResourceTypes.h for info on types and formatting |
Adam Lesinski | 59e04c6 | 2016-02-04 15:59:23 -0800 | [diff] [blame] | 339 | message Primitive { |
Michael Wachenschwanz | d06f1f3 | 2018-01-11 18:36:22 -0800 | [diff] [blame] | 340 | message NullType { |
| 341 | } |
| 342 | message EmptyType { |
| 343 | } |
| 344 | oneof oneof_value { |
| 345 | NullType null_value = 1; |
| 346 | EmptyType empty_value = 2; |
| 347 | float float_value = 3; |
Michael Wachenschwanz | 8b74927 | 2018-04-18 18:52:47 -0700 | [diff] [blame] | 348 | uint32 dimension_value = 13; |
| 349 | uint32 fraction_value = 14; |
Michael Wachenschwanz | d06f1f3 | 2018-01-11 18:36:22 -0800 | [diff] [blame] | 350 | int32 int_decimal_value = 6; |
Dave Ingram | 22ed412 | 2018-01-30 16:11:52 -0800 | [diff] [blame] | 351 | uint32 int_hexadecimal_value = 7; |
Michael Wachenschwanz | d06f1f3 | 2018-01-11 18:36:22 -0800 | [diff] [blame] | 352 | bool boolean_value = 8; |
| 353 | uint32 color_argb8_value = 9; |
| 354 | uint32 color_rgb8_value = 10; |
| 355 | uint32 color_argb4_value = 11; |
| 356 | uint32 color_rgb4_value = 12; |
Michael Wachenschwanz | 8b74927 | 2018-04-18 18:52:47 -0700 | [diff] [blame] | 357 | float dimension_value_deprecated = 4 [deprecated=true]; |
| 358 | float fraction_value_deprecated = 5 [deprecated=true]; |
Michael Wachenschwanz | d06f1f3 | 2018-01-11 18:36:22 -0800 | [diff] [blame] | 359 | } |
Adam Lesinski | 59e04c6 | 2016-02-04 15:59:23 -0800 | [diff] [blame] | 360 | } |
| 361 | |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 362 | // A value that represents an XML attribute and what values it accepts. |
Adam Lesinski | 59e04c6 | 2016-02-04 15:59:23 -0800 | [diff] [blame] | 363 | message Attribute { |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 364 | // A Symbol used to represent an enum or a flag. |
| 365 | message Symbol { |
| 366 | // Where the enum/flag item was defined. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 367 | Source source = 1; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 368 | |
| 369 | // Any comments associated with the enum or flag. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 370 | string comment = 2; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 371 | |
| 372 | // The name of the enum/flag as a reference. Enums/flag items are generated as ID resource |
| 373 | // values. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 374 | Reference name = 3; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 375 | |
| 376 | // The value of the enum/flag. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 377 | uint32 value = 4; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 378 | } |
| 379 | |
Adam Lesinski | 4ffea04 | 2017-08-10 15:37:28 -0700 | [diff] [blame] | 380 | // Bitmask of formats allowed for an attribute. |
| 381 | enum FormatFlags { |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 382 | NONE = 0x0; // Proto3 requires a default of 0. |
Adam Lesinski | 4ffea04 | 2017-08-10 15:37:28 -0700 | [diff] [blame] | 383 | ANY = 0x0000ffff; // Allows any type except ENUM and FLAGS. |
| 384 | REFERENCE = 0x01; // Allows Reference values. |
| 385 | STRING = 0x02; // Allows String/StyledString values. |
| 386 | INTEGER = 0x04; // Allows any integer BinaryPrimitive values. |
| 387 | BOOLEAN = 0x08; // Allows any boolean BinaryPrimitive values. |
| 388 | COLOR = 0x010; // Allows any color BinaryPrimitive values. |
| 389 | FLOAT = 0x020; // Allows any float BinaryPrimitive values. |
| 390 | DIMENSION = 0x040; // Allows any dimension BinaryPrimitive values. |
| 391 | FRACTION = 0x080; // Allows any fraction BinaryPrimitive values. |
| 392 | ENUM = 0x00010000; // Allows enums that are defined in the Attribute's symbols. |
| 393 | // ENUM and FLAGS cannot BOTH be set. |
| 394 | FLAGS = 0x00020000; // Allows flags that are defined in the Attribute's symbols. |
| 395 | // ENUM and FLAGS cannot BOTH be set. |
| 396 | } |
| 397 | |
| 398 | // A bitmask of types that this XML attribute accepts. Corresponds to the flags in the |
| 399 | // enum FormatFlags. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 400 | uint32 format_flags = 1; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 401 | |
| 402 | // The smallest integer allowed for this XML attribute. Only makes sense if the format includes |
Adam Lesinski | 4ffea04 | 2017-08-10 15:37:28 -0700 | [diff] [blame] | 403 | // FormatFlags::INTEGER. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 404 | int32 min_int = 2; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 405 | |
| 406 | // The largest integer allowed for this XML attribute. Only makes sense if the format includes |
Adam Lesinski | 4ffea04 | 2017-08-10 15:37:28 -0700 | [diff] [blame] | 407 | // FormatFlags::INTEGER. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 408 | int32 max_int = 3; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 409 | |
| 410 | // The set of enums/flags defined in this attribute. Only makes sense if the format includes |
Adam Lesinski | 4ffea04 | 2017-08-10 15:37:28 -0700 | [diff] [blame] | 411 | // either FormatFlags::ENUM or FormatFlags::FLAGS. Having both is an error. |
| 412 | repeated Symbol symbol = 4; |
Adam Lesinski | 59e04c6 | 2016-02-04 15:59:23 -0800 | [diff] [blame] | 413 | } |
| 414 | |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 415 | // A value that represents a style. |
Adam Lesinski | 59e04c6 | 2016-02-04 15:59:23 -0800 | [diff] [blame] | 416 | message Style { |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 417 | // An XML attribute/value pair defined in the style. |
| 418 | message Entry { |
| 419 | // Where the entry was defined. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 420 | Source source = 1; |
Adam Lesinski | 59e04c6 | 2016-02-04 15:59:23 -0800 | [diff] [blame] | 421 | |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 422 | // Any comments associated with the entry. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 423 | string comment = 2; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 424 | |
| 425 | // A reference to the XML attribute. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 426 | Reference key = 3; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 427 | |
| 428 | // The Item defined for this XML attribute. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 429 | Item item = 4; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 430 | } |
| 431 | |
| 432 | // The optinal style from which this style inherits attributes. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 433 | Reference parent = 1; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 434 | |
| 435 | // The source file information of the parent inheritance declaration. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 436 | Source parent_source = 2; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 437 | |
| 438 | // The set of XML attribute/value pairs for this style. |
Adam Lesinski | 4ffea04 | 2017-08-10 15:37:28 -0700 | [diff] [blame] | 439 | repeated Entry entry = 3; |
Adam Lesinski | 59e04c6 | 2016-02-04 15:59:23 -0800 | [diff] [blame] | 440 | } |
| 441 | |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 442 | // A value that represents a <declare-styleable> XML resource. These are not real resources and |
| 443 | // only end up as Java fields in the generated R.java. They do not end up in the binary ARSC file. |
Adam Lesinski | 59e04c6 | 2016-02-04 15:59:23 -0800 | [diff] [blame] | 444 | message Styleable { |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 445 | // An attribute defined for this styleable. |
| 446 | message Entry { |
| 447 | // Where the attribute was defined within the <declare-styleable> block. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 448 | Source source = 1; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 449 | |
| 450 | // Any comments associated with the declaration. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 451 | string comment = 2; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 452 | |
| 453 | // The reference to the attribute. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 454 | Reference attr = 3; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 455 | } |
| 456 | |
| 457 | // The set of attribute declarations. |
Adam Lesinski | 4ffea04 | 2017-08-10 15:37:28 -0700 | [diff] [blame] | 458 | repeated Entry entry = 1; |
Adam Lesinski | 59e04c6 | 2016-02-04 15:59:23 -0800 | [diff] [blame] | 459 | } |
| 460 | |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 461 | // A value that represents an array of resource values. |
Adam Lesinski | 59e04c6 | 2016-02-04 15:59:23 -0800 | [diff] [blame] | 462 | message Array { |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 463 | // A single element of the array. |
Adam Lesinski | 4ffea04 | 2017-08-10 15:37:28 -0700 | [diff] [blame] | 464 | message Element { |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 465 | // Where the element was defined. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 466 | Source source = 1; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 467 | |
| 468 | // Any comments associated with the element. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 469 | string comment = 2; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 470 | |
| 471 | // The value assigned to this element. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 472 | Item item = 3; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 473 | } |
| 474 | |
| 475 | // The list of array elements. |
Adam Lesinski | 4ffea04 | 2017-08-10 15:37:28 -0700 | [diff] [blame] | 476 | repeated Element element = 1; |
Adam Lesinski | 59e04c6 | 2016-02-04 15:59:23 -0800 | [diff] [blame] | 477 | } |
| 478 | |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 479 | // A value that represents a string and its many variations based on plurality. |
Adam Lesinski | 59e04c6 | 2016-02-04 15:59:23 -0800 | [diff] [blame] | 480 | message Plural { |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 481 | // The arity of the plural. |
| 482 | enum Arity { |
Adam Lesinski | 4ffea04 | 2017-08-10 15:37:28 -0700 | [diff] [blame] | 483 | ZERO = 0; |
| 484 | ONE = 1; |
| 485 | TWO = 2; |
| 486 | FEW = 3; |
| 487 | MANY = 4; |
| 488 | OTHER = 5; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 489 | } |
Adam Lesinski | 59e04c6 | 2016-02-04 15:59:23 -0800 | [diff] [blame] | 490 | |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 491 | // The plural value for a given arity. |
| 492 | message Entry { |
| 493 | // Where the plural was defined. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 494 | Source source = 1; |
Adam Lesinski | 59e04c6 | 2016-02-04 15:59:23 -0800 | [diff] [blame] | 495 | |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 496 | // Any comments associated with the plural. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 497 | string comment = 2; |
Adam Lesinski | 59e04c6 | 2016-02-04 15:59:23 -0800 | [diff] [blame] | 498 | |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 499 | // The arity of the plural. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 500 | Arity arity = 3; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 501 | |
| 502 | // The value assigned to this plural. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 503 | Item item = 4; |
Adam Lesinski | 0c80895 | 2017-07-10 05:40:39 -0700 | [diff] [blame] | 504 | } |
| 505 | |
| 506 | // The set of arity/plural mappings. |
Adam Lesinski | 4ffea04 | 2017-08-10 15:37:28 -0700 | [diff] [blame] | 507 | repeated Entry entry = 1; |
| 508 | } |
| 509 | |
| 510 | // Defines an abstract XmlNode that must be either an XmlElement, or |
| 511 | // a text node represented by a string. |
| 512 | message XmlNode { |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 513 | oneof node { |
| 514 | XmlElement element = 1; |
| 515 | string text = 2; |
| 516 | } |
Adam Lesinski | 4ffea04 | 2017-08-10 15:37:28 -0700 | [diff] [blame] | 517 | |
| 518 | // Source line and column info. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 519 | SourcePosition source = 3; |
Adam Lesinski | 4ffea04 | 2017-08-10 15:37:28 -0700 | [diff] [blame] | 520 | } |
| 521 | |
| 522 | // An <element> in an XML document. |
| 523 | message XmlElement { |
| 524 | // Namespaces defined on this element. |
| 525 | repeated XmlNamespace namespace_declaration = 1; |
| 526 | |
| 527 | // The namespace URI of this element. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 528 | string namespace_uri = 2; |
Adam Lesinski | 4ffea04 | 2017-08-10 15:37:28 -0700 | [diff] [blame] | 529 | |
| 530 | // The name of this element. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 531 | string name = 3; |
Adam Lesinski | 4ffea04 | 2017-08-10 15:37:28 -0700 | [diff] [blame] | 532 | |
| 533 | // The attributes of this element. |
| 534 | repeated XmlAttribute attribute = 4; |
| 535 | |
| 536 | // The children of this element. |
| 537 | repeated XmlNode child = 5; |
| 538 | } |
| 539 | |
| 540 | // A namespace declaration on an XmlElement (xmlns:android="http://..."). |
| 541 | message XmlNamespace { |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 542 | string prefix = 1; |
| 543 | string uri = 2; |
Adam Lesinski | 4ffea04 | 2017-08-10 15:37:28 -0700 | [diff] [blame] | 544 | |
| 545 | // Source line and column info. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 546 | SourcePosition source = 3; |
Adam Lesinski | 4ffea04 | 2017-08-10 15:37:28 -0700 | [diff] [blame] | 547 | } |
| 548 | |
| 549 | // An attribute defined on an XmlElement (android:text="..."). |
| 550 | message XmlAttribute { |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 551 | string namespace_uri = 1; |
| 552 | string name = 2; |
| 553 | string value = 3; |
Adam Lesinski | 4ffea04 | 2017-08-10 15:37:28 -0700 | [diff] [blame] | 554 | |
| 555 | // Source line and column info. |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 556 | SourcePosition source = 4; |
Adam Lesinski | 4ffea04 | 2017-08-10 15:37:28 -0700 | [diff] [blame] | 557 | |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 558 | // The optional resource ID (0xPPTTEEEE) of the attribute. |
| 559 | uint32 resource_id = 5; |
Adam Lesinski | 4ffea04 | 2017-08-10 15:37:28 -0700 | [diff] [blame] | 560 | |
Adam Lesinski | 5bd4423 | 2017-09-07 09:39:07 -0700 | [diff] [blame] | 561 | // The optional interpreted/compiled version of the `value` string. |
| 562 | Item compiled_item = 6; |
Adam Lesinski | 59e04c6 | 2016-02-04 15:59:23 -0800 | [diff] [blame] | 563 | } |