xref: /aosp_15_r20/prebuilts/devtools/repository/sdk-repository-05.xsd (revision 4bfccde5c7e9ea06f821db40ef0af54f6695c320)
1*4bfccde5SXin Li<?xml version="1.0" encoding="UTF-8"?>
2*4bfccde5SXin Li<!--
3*4bfccde5SXin Li * Copyright (C) 2011 The Android Open Source Project
4*4bfccde5SXin Li *
5*4bfccde5SXin Li * Licensed under the Apache License, Version 2.0 (the "License");
6*4bfccde5SXin Li * you may not use this file except in compliance with the License.
7*4bfccde5SXin Li * You may obtain a copy of the License at
8*4bfccde5SXin Li *
9*4bfccde5SXin Li *      http://www.apache.org/licenses/LICENSE-2.0
10*4bfccde5SXin Li *
11*4bfccde5SXin Li * Unless required by applicable law or agreed to in writing, software
12*4bfccde5SXin Li * distributed under the License is distributed on an "AS IS" BASIS,
13*4bfccde5SXin Li * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14*4bfccde5SXin Li * See the License for the specific language governing permissions and
15*4bfccde5SXin Li * limitations under the License.
16*4bfccde5SXin Li-->
17*4bfccde5SXin Li<xsd:schema
18*4bfccde5SXin Li    targetNamespace="http://schemas.android.com/sdk/android/repository/5"
19*4bfccde5SXin Li    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
20*4bfccde5SXin Li    xmlns:sdk="http://schemas.android.com/sdk/android/repository/5"
21*4bfccde5SXin Li    elementFormDefault="qualified"
22*4bfccde5SXin Li    attributeFormDefault="unqualified"
23*4bfccde5SXin Li    version="1">
24*4bfccde5SXin Li
25*4bfccde5SXin Li    <!-- The repository contains a collection of downloadable items known as
26*4bfccde5SXin Li         "packages". Each package has a type and various attributes and contains
27*4bfccde5SXin Li         a list of file "archives" that can be downloaded for specific OSes.
28*4bfccde5SXin Li
29*4bfccde5SXin Li         An Android SDK repository is a web site that contains a "repository.xml"
30*4bfccde5SXin Li         file that conforms to this XML Schema.
31*4bfccde5SXin Li
32*4bfccde5SXin Li         History:
33*4bfccde5SXin Li         - v1 is used by the SDK Updater in Tools r3 and r4.
34*4bfccde5SXin Li
35*4bfccde5SXin Li         - v2 is used by the SDK Updater in Tools r5:
36*4bfccde5SXin Li            - It introduces a new <sample> repository type. Previously samples
37*4bfccde5SXin Li              were included in the <platform> packages. Instead this package is used
38*4bfccde5SXin Li              and and the samples are installed in $SDK/samples.
39*4bfccde5SXin Li            - All repository types have a new <obsolete> node. It works as a marker
40*4bfccde5SXin Li              to indicate the package is obsolete and should not be selected by default.
41*4bfccde5SXin Li              The UI also hides these out by default.
42*4bfccde5SXin Li
43*4bfccde5SXin Li         - v3 is used by the SDK Updater in Tools r8:
44*4bfccde5SXin Li            - It introduces a new <platform-tool> repository type. Previously platform-specific
45*4bfccde5SXin Li              tools were included in the <platform> packages. Instead this package is used
46*4bfccde5SXin Li              and platform-specific tools are installed in $SDK/platform-tools
47*4bfccde5SXin Li            - There's a new element <min-platform-tools-rev> in <tool>. The tool package now
48*4bfccde5SXin Li              requires that at least some minimal version of <platform-tool> be installed.
49*4bfccde5SXin Li            - It removes the <addon> repository type, which is now in its own XML Schema.
50*4bfccde5SXin Li
51*4bfccde5SXin Li         - v4 is used by the SDK Updater in Tools r12:
52*4bfccde5SXin Li            - <extra> element now has a <project-files> element that contains 1 or
53*4bfccde5SXin Li              or more <path>, each indicating the relative path of a file that this package
54*4bfccde5SXin Li              can contribute to installed projects.
55*4bfccde5SXin Li            - <platform> element now has a mandatory <layoutlib> that indicates the API
56*4bfccde5SXin Li              and revision of that layout library for this particular platform.
57*4bfccde5SXin Li
58*4bfccde5SXin Li         - v5 is used by the SDK Updater in Tools R14:
59*4bfccde5SXin Li            - <extra> now has an <old-paths> element, a ;-separated list of old paths that
60*4bfccde5SXin Li              should be detected and migrated to the new <path> for that package.
61*4bfccde5SXin Li            - <platform> has a new optional <abi-included> that describes the ABI of the
62*4bfccde5SXin Li              system image included in the platform, if any.
63*4bfccde5SXin Li            - New <system-image> package type, to store system images outside of <platform>s.
64*4bfccde5SXin Li            - New <source> package type.
65*4bfccde5SXin Li    -->
66*4bfccde5SXin Li
67*4bfccde5SXin Li    <xsd:element name="sdk-repository" type="sdk:repositoryType" />
68*4bfccde5SXin Li
69*4bfccde5SXin Li    <xsd:complexType name="repositoryType">
70*4bfccde5SXin Li        <xsd:annotation>
71*4bfccde5SXin Li            <xsd:documentation>
72*4bfccde5SXin Li                The repository contains a collection of downloadable packages.
73*4bfccde5SXin Li            </xsd:documentation>
74*4bfccde5SXin Li        </xsd:annotation>
75*4bfccde5SXin Li        <xsd:choice minOccurs="0" maxOccurs="unbounded">
76*4bfccde5SXin Li            <xsd:element name="platform"        type="sdk:platformType"     />
77*4bfccde5SXin Li            <xsd:element name="system-image"    type="sdk:systemImageType"  />
78*4bfccde5SXin Li            <xsd:element name="source"          type="sdk:sourceType"       />
79*4bfccde5SXin Li            <xsd:element name="tool"            type="sdk:toolType"         />
80*4bfccde5SXin Li            <xsd:element name="platform-tool"   type="sdk:platformToolType" />
81*4bfccde5SXin Li            <xsd:element name="doc"             type="sdk:docType"          />
82*4bfccde5SXin Li            <xsd:element name="sample"          type="sdk:sampleType"       />
83*4bfccde5SXin Li            <xsd:element name="extra"           type="sdk:extraType"        />
84*4bfccde5SXin Li            <xsd:element name="license"         type="sdk:licenseType"      />
85*4bfccde5SXin Li        </xsd:choice>
86*4bfccde5SXin Li    </xsd:complexType>
87*4bfccde5SXin Li
88*4bfccde5SXin Li    <!-- The definition of an SDK platform package. -->
89*4bfccde5SXin Li
90*4bfccde5SXin Li    <xsd:complexType name="platformType">
91*4bfccde5SXin Li        <xsd:annotation>
92*4bfccde5SXin Li            <xsd:documentation>An SDK platform package.</xsd:documentation>
93*4bfccde5SXin Li        </xsd:annotation>
94*4bfccde5SXin Li        <xsd:all>
95*4bfccde5SXin Li            <!-- The Android platform version. It is string such as "1.0". -->
96*4bfccde5SXin Li            <xsd:element name="version"   type="xsd:normalizedString" />
97*4bfccde5SXin Li            <!-- The Android API Level for the platform. An int > 0. -->
98*4bfccde5SXin Li            <xsd:element name="api-level" type="xsd:positiveInteger"  />
99*4bfccde5SXin Li            <!-- The optional codename for this platform, if it's a preview. -->
100*4bfccde5SXin Li            <xsd:element name="codename"  type="xsd:string" minOccurs="0" />
101*4bfccde5SXin Li            <!-- The revision, an int > 0, incremented each time a new
102*4bfccde5SXin Li                 package is generated. -->
103*4bfccde5SXin Li            <xsd:element name="revision"  type="xsd:positiveInteger" />
104*4bfccde5SXin Li
105*4bfccde5SXin Li            <!-- Information on the layoutlib packaged in this platform. -->
106*4bfccde5SXin Li            <xsd:element name="layoutlib" type="sdk:layoutlibType" />
107*4bfccde5SXin Li
108*4bfccde5SXin Li            <!-- optional elements -->
109*4bfccde5SXin Li
110*4bfccde5SXin Li            <!-- The optional license of this package. If present, users will have
111*4bfccde5SXin Li                 to agree to it before downloading. -->
112*4bfccde5SXin Li            <xsd:element name="uses-license"  type="sdk:usesLicenseType" minOccurs="0" />
113*4bfccde5SXin Li            <!-- The optional description of this package. -->
114*4bfccde5SXin Li            <xsd:element name="description"   type="xsd:string"      minOccurs="0" />
115*4bfccde5SXin Li            <!-- The optional description URL of this package -->
116*4bfccde5SXin Li            <xsd:element name="desc-url"      type="xsd:token"       minOccurs="0" />
117*4bfccde5SXin Li            <!-- The optional release note for this package. -->
118*4bfccde5SXin Li            <xsd:element name="release-note"  type="xsd:string"      minOccurs="0" />
119*4bfccde5SXin Li            <!-- The optional release note URL of this package -->
120*4bfccde5SXin Li            <xsd:element name="release-url"   type="xsd:token"       minOccurs="0" />
121*4bfccde5SXin Li            <!-- A list of file archives for this package. -->
122*4bfccde5SXin Li            <xsd:element name="archives"      type="sdk:archivesType" />
123*4bfccde5SXin Li            <!-- The minimal revision of tools required by this package.
124*4bfccde5SXin Li                 Optional. If present, must be an int > 0. -->
125*4bfccde5SXin Li            <xsd:element name="min-tools-rev" type="xsd:positiveInteger" minOccurs="0" />
126*4bfccde5SXin Li
127*4bfccde5SXin Li            <!-- The ABI of the system image *included* in this platform, if any.
128*4bfccde5SXin Li                 When the field is present, it means the platform already embeds one
129*4bfccde5SXin Li                 system image. A platform can also have any number of external
130*4bfccde5SXin Li                 &lt;system-image&gt; associated with it.  -->
131*4bfccde5SXin Li            <xsd:element name="included-abi"  type="sdk:abiType" minOccurs="0" />
132*4bfccde5SXin Li
133*4bfccde5SXin Li            <!-- An optional element indicating the package is obsolete.
134*4bfccde5SXin Li                 The string content is however currently not defined and ignored. -->
135*4bfccde5SXin Li            <xsd:element name="obsolete"      type="xsd:string" minOccurs="0" />
136*4bfccde5SXin Li        </xsd:all>
137*4bfccde5SXin Li    </xsd:complexType>
138*4bfccde5SXin Li
139*4bfccde5SXin Li
140*4bfccde5SXin Li    <!-- The definition of a layout library used by a platform. -->
141*4bfccde5SXin Li
142*4bfccde5SXin Li    <xsd:complexType name="layoutlibType" >
143*4bfccde5SXin Li        <xsd:annotation>
144*4bfccde5SXin Li            <xsd:documentation>
145*4bfccde5SXin Li                Version information for a layoutlib included in a platform.
146*4bfccde5SXin Li            </xsd:documentation>
147*4bfccde5SXin Li        </xsd:annotation>
148*4bfccde5SXin Li        <xsd:all>
149*4bfccde5SXin Li            <!-- The layoutlib API level, an int > 0,
150*4bfccde5SXin Li                 incremented with each new incompatible lib. -->
151*4bfccde5SXin Li            <xsd:element name="api"          type="xsd:positiveInteger" />
152*4bfccde5SXin Li            <!-- The incremental minor revision for that API, e.g. in case of bug fixes.
153*4bfccde5SXin Li                 Optional. An int >= 0, assumed to be 0 if the element is missing. -->
154*4bfccde5SXin Li            <xsd:element name="revision"     type="xsd:nonNegativeInteger" minOccurs="0" />
155*4bfccde5SXin Li        </xsd:all>
156*4bfccde5SXin Li    </xsd:complexType>
157*4bfccde5SXin Li
158*4bfccde5SXin Li
159*4bfccde5SXin Li    <!-- The definition of a system image used by a platform. -->
160*4bfccde5SXin Li
161*4bfccde5SXin Li    <xsd:complexType name="systemImageType" >
162*4bfccde5SXin Li        <xsd:annotation>
163*4bfccde5SXin Li            <xsd:documentation>
164*4bfccde5SXin Li                System Image for a platform.
165*4bfccde5SXin Li            </xsd:documentation>
166*4bfccde5SXin Li        </xsd:annotation>
167*4bfccde5SXin Li        <xsd:all>
168*4bfccde5SXin Li            <!-- api-level + codename identifies the platform to which this system image belongs. -->
169*4bfccde5SXin Li
170*4bfccde5SXin Li            <!-- The Android API Level for the platform. An int > 0. -->
171*4bfccde5SXin Li            <xsd:element name="api-level" type="xsd:positiveInteger"  />
172*4bfccde5SXin Li            <!-- The optional codename for this platform, if it's a preview. -->
173*4bfccde5SXin Li            <xsd:element name="codename"  type="xsd:string" minOccurs="0" />
174*4bfccde5SXin Li
175*4bfccde5SXin Li            <!-- The revision, an int > 0, incremented each time a new
176*4bfccde5SXin Li                 package is generated. -->
177*4bfccde5SXin Li            <xsd:element name="revision"  type="xsd:positiveInteger" />
178*4bfccde5SXin Li
179*4bfccde5SXin Li            <!-- The ABI of the system emulated by this image. -->
180*4bfccde5SXin Li            <xsd:element name="abi"       type="sdk:abiType" />
181*4bfccde5SXin Li
182*4bfccde5SXin Li            <!-- The optional license of this package. If present, users will have
183*4bfccde5SXin Li                 to agree to it before downloading. -->
184*4bfccde5SXin Li            <xsd:element name="uses-license"  type="sdk:usesLicenseType" minOccurs="0" />
185*4bfccde5SXin Li            <!-- The optional description of this package. -->
186*4bfccde5SXin Li            <xsd:element name="description"   type="xsd:string"      minOccurs="0" />
187*4bfccde5SXin Li            <!-- The optional description URL of this package -->
188*4bfccde5SXin Li            <xsd:element name="desc-url"      type="xsd:token"       minOccurs="0" />
189*4bfccde5SXin Li            <!-- The optional release note for this package. -->
190*4bfccde5SXin Li            <xsd:element name="release-note"  type="xsd:string"      minOccurs="0" />
191*4bfccde5SXin Li            <!-- The optional release note URL of this package -->
192*4bfccde5SXin Li            <xsd:element name="release-url"   type="xsd:token"       minOccurs="0" />
193*4bfccde5SXin Li
194*4bfccde5SXin Li            <!-- A list of file archives for this package. -->
195*4bfccde5SXin Li            <xsd:element name="archives"  type="sdk:archivesType" />
196*4bfccde5SXin Li        </xsd:all>
197*4bfccde5SXin Li    </xsd:complexType>
198*4bfccde5SXin Li
199*4bfccde5SXin Li    <!-- The definition of the ABI supported by a platform's system image. -->
200*4bfccde5SXin Li
201*4bfccde5SXin Li    <xsd:simpleType name="abiType">
202*4bfccde5SXin Li        <xsd:annotation>
203*4bfccde5SXin Li            <xsd:documentation>The ABI of a platform's system image.</xsd:documentation>
204*4bfccde5SXin Li        </xsd:annotation>
205*4bfccde5SXin Li        <xsd:restriction base="xsd:token">
206*4bfccde5SXin Li            <xsd:enumeration value="armeabi"     />
207*4bfccde5SXin Li            <xsd:enumeration value="armeabi-v7a" />
208*4bfccde5SXin Li            <xsd:enumeration value="x86"         />
209*4bfccde5SXin Li        </xsd:restriction>
210*4bfccde5SXin Li    </xsd:simpleType>
211*4bfccde5SXin Li
212*4bfccde5SXin Li
213*4bfccde5SXin Li    <!-- The definition of a source package. -->
214*4bfccde5SXin Li
215*4bfccde5SXin Li    <xsd:complexType name="sourceType" >
216*4bfccde5SXin Li        <xsd:annotation>
217*4bfccde5SXin Li            <xsd:documentation>
218*4bfccde5SXin Li                Sources for a platform.
219*4bfccde5SXin Li            </xsd:documentation>
220*4bfccde5SXin Li        </xsd:annotation>
221*4bfccde5SXin Li        <xsd:all>
222*4bfccde5SXin Li            <!-- api-level + codename identifies the platform to which this source belongs. -->
223*4bfccde5SXin Li
224*4bfccde5SXin Li            <!-- The Android API Level for the platform. An int > 0. -->
225*4bfccde5SXin Li            <xsd:element name="api-level" type="xsd:positiveInteger"  />
226*4bfccde5SXin Li            <!-- The optional codename for this platform, if it's a preview. -->
227*4bfccde5SXin Li            <xsd:element name="codename"  type="xsd:string" minOccurs="0" />
228*4bfccde5SXin Li
229*4bfccde5SXin Li            <!-- The revision, an int > 0, incremented each time a new
230*4bfccde5SXin Li                 package is generated. -->
231*4bfccde5SXin Li            <xsd:element name="revision"  type="xsd:positiveInteger" />
232*4bfccde5SXin Li
233*4bfccde5SXin Li            <!-- The optional license of this package. If present, users will have
234*4bfccde5SXin Li                 to agree to it before downloading. -->
235*4bfccde5SXin Li            <xsd:element name="uses-license"  type="sdk:usesLicenseType" minOccurs="0" />
236*4bfccde5SXin Li            <!-- The optional description of this package. -->
237*4bfccde5SXin Li            <xsd:element name="description"   type="xsd:string"      minOccurs="0" />
238*4bfccde5SXin Li            <!-- The optional description URL of this package -->
239*4bfccde5SXin Li            <xsd:element name="desc-url"      type="xsd:token"       minOccurs="0" />
240*4bfccde5SXin Li            <!-- The optional release note for this package. -->
241*4bfccde5SXin Li            <xsd:element name="release-note"  type="xsd:string"      minOccurs="0" />
242*4bfccde5SXin Li            <!-- The optional release note URL of this package -->
243*4bfccde5SXin Li            <xsd:element name="release-url"   type="xsd:token"       minOccurs="0" />
244*4bfccde5SXin Li
245*4bfccde5SXin Li            <!-- A list of file archives for this package. -->
246*4bfccde5SXin Li            <xsd:element name="archives"  type="sdk:archivesType" />
247*4bfccde5SXin Li        </xsd:all>
248*4bfccde5SXin Li    </xsd:complexType>
249*4bfccde5SXin Li
250*4bfccde5SXin Li
251*4bfccde5SXin Li    <!-- The definition of an SDK tool package. -->
252*4bfccde5SXin Li
253*4bfccde5SXin Li    <xsd:complexType name="toolType" >
254*4bfccde5SXin Li        <xsd:annotation>
255*4bfccde5SXin Li            <xsd:documentation>An SDK tool package.</xsd:documentation>
256*4bfccde5SXin Li        </xsd:annotation>
257*4bfccde5SXin Li        <xsd:all>
258*4bfccde5SXin Li            <!-- The revision, an int > 0, incremented each time a new
259*4bfccde5SXin Li                 package is generated. -->
260*4bfccde5SXin Li            <xsd:element name="revision"     type="xsd:positiveInteger" />
261*4bfccde5SXin Li            <!-- The optional license of this package. If present, users will have
262*4bfccde5SXin Li                 to agree to it before downloading. -->
263*4bfccde5SXin Li            <xsd:element name="uses-license" type="sdk:usesLicenseType" minOccurs="0" />
264*4bfccde5SXin Li            <!-- The optional description of this package. -->
265*4bfccde5SXin Li            <xsd:element name="description"  type="xsd:string"      minOccurs="0" />
266*4bfccde5SXin Li            <!-- The optional description URL of this package -->
267*4bfccde5SXin Li            <xsd:element name="desc-url"     type="xsd:token"       minOccurs="0" />
268*4bfccde5SXin Li            <!-- The optional release note for this package. -->
269*4bfccde5SXin Li            <xsd:element name="release-note" type="xsd:string"      minOccurs="0" />
270*4bfccde5SXin Li            <!-- The optional release note URL of this package -->
271*4bfccde5SXin Li            <xsd:element name="release-url"  type="xsd:token"       minOccurs="0" />
272*4bfccde5SXin Li            <!-- A list of file archives for this package. -->
273*4bfccde5SXin Li            <xsd:element name="archives"     type="sdk:archivesType" />
274*4bfccde5SXin Li            <!-- An optional element indicating the package is obsolete.
275*4bfccde5SXin Li                 The string content is however currently not defined and ignored. -->
276*4bfccde5SXin Li            <xsd:element name="obsolete"  type="xsd:string" minOccurs="0" />
277*4bfccde5SXin Li
278*4bfccde5SXin Li            <!-- The minimal revision of platform-tools required by this package.
279*4bfccde5SXin Li                 Mandatory. Must be an int > 0. -->
280*4bfccde5SXin Li            <xsd:element name="min-platform-tools-rev" type="xsd:positiveInteger" />
281*4bfccde5SXin Li        </xsd:all>
282*4bfccde5SXin Li    </xsd:complexType>
283*4bfccde5SXin Li
284*4bfccde5SXin Li
285*4bfccde5SXin Li    <!-- The definition of an SDK platform-tool package. -->
286*4bfccde5SXin Li
287*4bfccde5SXin Li    <xsd:complexType name="platformToolType" >
288*4bfccde5SXin Li        <xsd:annotation>
289*4bfccde5SXin Li            <xsd:documentation>An SDK platform-tool package.</xsd:documentation>
290*4bfccde5SXin Li        </xsd:annotation>
291*4bfccde5SXin Li        <xsd:all>
292*4bfccde5SXin Li            <!-- The revision, an int > 0, incremented each time a new
293*4bfccde5SXin Li                 package is generated. -->
294*4bfccde5SXin Li            <xsd:element name="revision"     type="xsd:positiveInteger" />
295*4bfccde5SXin Li            <!-- The optional license of this package. If present, users will have
296*4bfccde5SXin Li                 to agree to it before downloading. -->
297*4bfccde5SXin Li            <xsd:element name="uses-license" type="sdk:usesLicenseType" minOccurs="0" />
298*4bfccde5SXin Li            <!-- The optional description of this package. -->
299*4bfccde5SXin Li            <xsd:element name="description"  type="xsd:string"      minOccurs="0" />
300*4bfccde5SXin Li            <!-- The optional description URL of this package -->
301*4bfccde5SXin Li            <xsd:element name="desc-url"     type="xsd:token"       minOccurs="0" />
302*4bfccde5SXin Li            <!-- The optional release note for this package. -->
303*4bfccde5SXin Li            <xsd:element name="release-note" type="xsd:string"      minOccurs="0" />
304*4bfccde5SXin Li            <!-- The optional release note URL of this package -->
305*4bfccde5SXin Li            <xsd:element name="release-url"  type="xsd:token"       minOccurs="0" />
306*4bfccde5SXin Li            <!-- A list of file archives for this package. -->
307*4bfccde5SXin Li            <xsd:element name="archives"     type="sdk:archivesType" />
308*4bfccde5SXin Li
309*4bfccde5SXin Li            <!-- An optional element indicating the package is obsolete.
310*4bfccde5SXin Li                 The string content is however currently not defined and ignored. -->
311*4bfccde5SXin Li            <xsd:element name="obsolete"  type="xsd:string" minOccurs="0" />
312*4bfccde5SXin Li        </xsd:all>
313*4bfccde5SXin Li    </xsd:complexType>
314*4bfccde5SXin Li
315*4bfccde5SXin Li
316*4bfccde5SXin Li    <!-- The definition of an SDK doc package. -->
317*4bfccde5SXin Li
318*4bfccde5SXin Li    <xsd:complexType name="docType" >
319*4bfccde5SXin Li        <xsd:annotation>
320*4bfccde5SXin Li            <xsd:documentation>An SDK doc package.</xsd:documentation>
321*4bfccde5SXin Li        </xsd:annotation>
322*4bfccde5SXin Li        <xsd:all>
323*4bfccde5SXin Li            <!-- The Android API Level for the documentation. An int > 0. -->
324*4bfccde5SXin Li            <xsd:element name="api-level" type="xsd:positiveInteger"  />
325*4bfccde5SXin Li            <!-- The optional codename for this doc, if it's a preview. -->
326*4bfccde5SXin Li            <xsd:element name="codename"  type="xsd:string" minOccurs="0" />
327*4bfccde5SXin Li
328*4bfccde5SXin Li            <!-- The revision, an int > 0, incremented each time a new
329*4bfccde5SXin Li                 package is generated. -->
330*4bfccde5SXin Li            <xsd:element name="revision"     type="xsd:positiveInteger" />
331*4bfccde5SXin Li            <!-- The optional license of this package. If present, users will have
332*4bfccde5SXin Li                 to agree to it before downloading. -->
333*4bfccde5SXin Li            <xsd:element name="uses-license" type="sdk:usesLicenseType" minOccurs="0" />
334*4bfccde5SXin Li            <!-- The optional description of this package. -->
335*4bfccde5SXin Li            <xsd:element name="description"  type="xsd:string"      minOccurs="0" />
336*4bfccde5SXin Li            <!-- The optional description URL of this package -->
337*4bfccde5SXin Li            <xsd:element name="desc-url"     type="xsd:token"       minOccurs="0" />
338*4bfccde5SXin Li            <!-- The optional release note for this package. -->
339*4bfccde5SXin Li            <xsd:element name="release-note" type="xsd:string"      minOccurs="0" />
340*4bfccde5SXin Li            <!-- The optional release note URL of this package -->
341*4bfccde5SXin Li            <xsd:element name="release-url"  type="xsd:token"       minOccurs="0" />
342*4bfccde5SXin Li            <!-- A list of file archives for this package. -->
343*4bfccde5SXin Li            <xsd:element name="archives"     type="sdk:archivesType" />
344*4bfccde5SXin Li
345*4bfccde5SXin Li            <!-- An optional element indicating the package is obsolete.
346*4bfccde5SXin Li                 The string content is however currently not defined and ignored. -->
347*4bfccde5SXin Li            <xsd:element name="obsolete"  type="xsd:string" minOccurs="0" />
348*4bfccde5SXin Li        </xsd:all>
349*4bfccde5SXin Li    </xsd:complexType>
350*4bfccde5SXin Li
351*4bfccde5SXin Li
352*4bfccde5SXin Li    <!-- The definition of an SDK sample package. -->
353*4bfccde5SXin Li
354*4bfccde5SXin Li    <xsd:complexType name="sampleType" >
355*4bfccde5SXin Li        <xsd:annotation>
356*4bfccde5SXin Li            <xsd:documentation>An SDK sample package.</xsd:documentation>
357*4bfccde5SXin Li        </xsd:annotation>
358*4bfccde5SXin Li        <xsd:all>
359*4bfccde5SXin Li            <!-- The Android API Level for the documentation. An int > 0. -->
360*4bfccde5SXin Li            <xsd:element name="api-level" type="xsd:positiveInteger"  />
361*4bfccde5SXin Li            <!-- The optional codename for this doc, if it's a preview. -->
362*4bfccde5SXin Li            <xsd:element name="codename"  type="xsd:string" minOccurs="0" />
363*4bfccde5SXin Li
364*4bfccde5SXin Li            <!-- The revision, an int > 0, incremented each time a new
365*4bfccde5SXin Li                 package is generated. -->
366*4bfccde5SXin Li            <xsd:element name="revision"     type="xsd:positiveInteger" />
367*4bfccde5SXin Li            <!-- The optional license of this package. If present, users will have
368*4bfccde5SXin Li                 to agree to it before downloading. -->
369*4bfccde5SXin Li            <xsd:element name="uses-license" type="sdk:usesLicenseType" minOccurs="0" />
370*4bfccde5SXin Li            <!-- The optional description of this package. -->
371*4bfccde5SXin Li            <xsd:element name="description"  type="xsd:string"      minOccurs="0" />
372*4bfccde5SXin Li            <!-- The optional description URL of this package -->
373*4bfccde5SXin Li            <xsd:element name="desc-url"     type="xsd:token"       minOccurs="0" />
374*4bfccde5SXin Li            <!-- The optional release note for this package. -->
375*4bfccde5SXin Li            <xsd:element name="release-note" type="xsd:string"      minOccurs="0" />
376*4bfccde5SXin Li            <!-- The optional release note URL of this package -->
377*4bfccde5SXin Li            <xsd:element name="release-url"  type="xsd:token"       minOccurs="0" />
378*4bfccde5SXin Li            <!-- A list of file archives for this package. -->
379*4bfccde5SXin Li            <xsd:element name="archives"     type="sdk:archivesType" />
380*4bfccde5SXin Li            <!-- The minimal revision of tools required by this package.
381*4bfccde5SXin Li                 Optional. If present, must be an int > 0. -->
382*4bfccde5SXin Li            <xsd:element name="min-tools-rev" type="xsd:positiveInteger" minOccurs="0" />
383*4bfccde5SXin Li
384*4bfccde5SXin Li            <!-- An optional element indicating the package is obsolete.
385*4bfccde5SXin Li                 The string content is however currently not defined and ignored. -->
386*4bfccde5SXin Li            <xsd:element name="obsolete"  type="xsd:string" minOccurs="0" />
387*4bfccde5SXin Li        </xsd:all>
388*4bfccde5SXin Li    </xsd:complexType>
389*4bfccde5SXin Li
390*4bfccde5SXin Li
391*4bfccde5SXin Li    <!-- The definition of an SDK extra package. This kind of package is for
392*4bfccde5SXin Li         "free" content. Such packages are installed in SDK/vendor/path.
393*4bfccde5SXin Li
394*4bfccde5SXin Li         Important implementation detail: this element is duplicated in the
395*4bfccde5SXin Li         sdk-addon-N.xsd schema and must be kept in sync there. This is
396*4bfccde5SXin Li         simpler than trying to use some kind of of include or to request
397*4bfccde5SXin Li         that clients use a third XML schema for common parts.
398*4bfccde5SXin Li    -->
399*4bfccde5SXin Li
400*4bfccde5SXin Li    <xsd:complexType name="extraType" >
401*4bfccde5SXin Li        <xsd:annotation>
402*4bfccde5SXin Li            <xsd:documentation>
403*4bfccde5SXin Li                An SDK extra package. This kind of package is for "free" content.
404*4bfccde5SXin Li                Such packages are installed in SDK/vendor/path.
405*4bfccde5SXin Li            </xsd:documentation>
406*4bfccde5SXin Li        </xsd:annotation>
407*4bfccde5SXin Li        <xsd:all>
408*4bfccde5SXin Li
409*4bfccde5SXin Li            <!-- The install path top folder name.
410*4bfccde5SXin Li                 The segments "add-ons", "docs", "platforms", "platform-tools", "temp"
411*4bfccde5SXin Li                 and "tools" are reserved and cannot be used.
412*4bfccde5SXin Li            -->
413*4bfccde5SXin Li            <xsd:element name="vendor" type="sdk:segmentType" />
414*4bfccde5SXin Li
415*4bfccde5SXin Li            <!-- The install path sub-folder name. -->
416*4bfccde5SXin Li            <xsd:element name="path" type="sdk:segmentType" />
417*4bfccde5SXin Li
418*4bfccde5SXin Li            <!-- A semi-colon separated list of "obsolete" path names which are equivalent
419*4bfccde5SXin Li                 to the current 'path' name. When a package is seen using an old-paths' name,
420*4bfccde5SXin Li                 the package manager will try to upgrade it to the new path. -->
421*4bfccde5SXin Li            <xsd:element name="old-paths" type="sdk:segmentListType"  minOccurs="0" />
422*4bfccde5SXin Li
423*4bfccde5SXin Li            <!-- The revision, an int > 0, incremented each time a new
424*4bfccde5SXin Li                 package is generated. -->
425*4bfccde5SXin Li            <xsd:element name="revision"     type="xsd:positiveInteger" />
426*4bfccde5SXin Li
427*4bfccde5SXin Li            <!-- A list of file archives for this package. -->
428*4bfccde5SXin Li            <xsd:element name="archives"     type="sdk:archivesType" />
429*4bfccde5SXin Li
430*4bfccde5SXin Li            <!--  optional elements -->
431*4bfccde5SXin Li
432*4bfccde5SXin Li            <!-- The optional license of this package. If present, users will have
433*4bfccde5SXin Li                 to agree to it before downloading. -->
434*4bfccde5SXin Li            <xsd:element name="uses-license" type="sdk:usesLicenseType"  minOccurs="0" />
435*4bfccde5SXin Li            <!-- The optional description of this package. -->
436*4bfccde5SXin Li            <xsd:element name="description"  type="xsd:string"           minOccurs="0" />
437*4bfccde5SXin Li            <!-- The optional description URL of this package -->
438*4bfccde5SXin Li            <xsd:element name="desc-url"     type="xsd:token"            minOccurs="0" />
439*4bfccde5SXin Li            <!-- The optional release note for this package. -->
440*4bfccde5SXin Li            <xsd:element name="release-note" type="xsd:string"           minOccurs="0" />
441*4bfccde5SXin Li            <!-- The optional release note URL of this package -->
442*4bfccde5SXin Li            <xsd:element name="release-url"  type="xsd:token"            minOccurs="0" />
443*4bfccde5SXin Li            <!-- The minimal revision of tools required by this package.
444*4bfccde5SXin Li                 Optional. If present, must be an int > 0. -->
445*4bfccde5SXin Li            <xsd:element name="min-tools-rev" type="xsd:positiveInteger" minOccurs="0" />
446*4bfccde5SXin Li            <!-- The minimal API level required by this package.
447*4bfccde5SXin Li                 Optional. If present, must be an int > 0. -->
448*4bfccde5SXin Li            <xsd:element name="min-api-level" type="xsd:positiveInteger" minOccurs="0" />
449*4bfccde5SXin Li            <!-- An optional element indicating the package is obsolete.
450*4bfccde5SXin Li                 The string content is however currently not defined and ignored. -->
451*4bfccde5SXin Li            <xsd:element name="obsolete"      type="xsd:string"          minOccurs="0" />
452*4bfccde5SXin Li
453*4bfccde5SXin Li            <!-- A list of project files contributed by this package. Optional. -->
454*4bfccde5SXin Li            <xsd:element name="project-files" type="sdk:projectFilesType" minOccurs="0" />
455*4bfccde5SXin Li        </xsd:all>
456*4bfccde5SXin Li    </xsd:complexType>
457*4bfccde5SXin Li
458*4bfccde5SXin Li
459*4bfccde5SXin Li    <!-- The definition of a path segment used by the extra element. -->
460*4bfccde5SXin Li
461*4bfccde5SXin Li    <xsd:simpleType name="segmentType">
462*4bfccde5SXin Li        <xsd:annotation>
463*4bfccde5SXin Li            <xsd:documentation>
464*4bfccde5SXin Li                One path segment for the install path of an extra element.
465*4bfccde5SXin Li                It must be a single-segment path.
466*4bfccde5SXin Li            </xsd:documentation>
467*4bfccde5SXin Li        </xsd:annotation>
468*4bfccde5SXin Li        <xsd:restriction base="xsd:token">
469*4bfccde5SXin Li            <xsd:pattern value="[a-zA-Z0-9_]+"/>
470*4bfccde5SXin Li        </xsd:restriction>
471*4bfccde5SXin Li    </xsd:simpleType>
472*4bfccde5SXin Li
473*4bfccde5SXin Li    <xsd:simpleType name="segmentListType">
474*4bfccde5SXin Li        <xsd:annotation>
475*4bfccde5SXin Li            <xsd:documentation>
476*4bfccde5SXin Li                A semi-colon separated list of a segmentTypes.
477*4bfccde5SXin Li            </xsd:documentation>
478*4bfccde5SXin Li        </xsd:annotation>
479*4bfccde5SXin Li        <xsd:restriction base="xsd:token">
480*4bfccde5SXin Li            <xsd:pattern value="[a-zA-Z0-9_;]+"/>
481*4bfccde5SXin Li        </xsd:restriction>
482*4bfccde5SXin Li    </xsd:simpleType>
483*4bfccde5SXin Li
484*4bfccde5SXin Li
485*4bfccde5SXin Li    <!-- The definition of a license to be referenced by the uses-license element. -->
486*4bfccde5SXin Li
487*4bfccde5SXin Li    <xsd:complexType name="licenseType">
488*4bfccde5SXin Li        <xsd:annotation>
489*4bfccde5SXin Li            <xsd:documentation>
490*4bfccde5SXin Li                A license definition. Such a license must be used later as a reference
491*4bfccde5SXin Li                using a uses-license element in one of the package elements.
492*4bfccde5SXin Li            </xsd:documentation>
493*4bfccde5SXin Li        </xsd:annotation>
494*4bfccde5SXin Li        <xsd:simpleContent>
495*4bfccde5SXin Li            <xsd:extension base="xsd:string">
496*4bfccde5SXin Li                <xsd:attribute name="id"   type="xsd:ID" />
497*4bfccde5SXin Li                <xsd:attribute name="type" type="xsd:token" fixed="text" />
498*4bfccde5SXin Li            </xsd:extension>
499*4bfccde5SXin Li        </xsd:simpleContent>
500*4bfccde5SXin Li    </xsd:complexType>
501*4bfccde5SXin Li
502*4bfccde5SXin Li
503*4bfccde5SXin Li    <!-- Type describing the license used by a package.
504*4bfccde5SXin Li         The license MUST be defined using a license node and referenced
505*4bfccde5SXin Li         using the ref attribute of the license element inside a package.
506*4bfccde5SXin Li     -->
507*4bfccde5SXin Li
508*4bfccde5SXin Li    <xsd:complexType name="usesLicenseType">
509*4bfccde5SXin Li        <xsd:annotation>
510*4bfccde5SXin Li            <xsd:documentation>
511*4bfccde5SXin Li                Describes the license used by a package. The license MUST be defined
512*4bfccde5SXin Li                using a license node and referenced using the ref attribute of the
513*4bfccde5SXin Li                license element inside a package.
514*4bfccde5SXin Li            </xsd:documentation>
515*4bfccde5SXin Li        </xsd:annotation>
516*4bfccde5SXin Li        <xsd:attribute name="ref" type="xsd:IDREF" />
517*4bfccde5SXin Li    </xsd:complexType>
518*4bfccde5SXin Li
519*4bfccde5SXin Li
520*4bfccde5SXin Li    <!-- A collection of files that can be downloaded for a given architecture.
521*4bfccde5SXin Li         The <archives> node is mandatory in the repository elements and the
522*4bfccde5SXin Li         collection must have at least one <archive> declared.
523*4bfccde5SXin Li         Each archive is a zip file that will be unzipped in a location that depends
524*4bfccde5SXin Li         on its package type.
525*4bfccde5SXin Li     -->
526*4bfccde5SXin Li
527*4bfccde5SXin Li    <xsd:complexType name="archivesType">
528*4bfccde5SXin Li        <xsd:annotation>
529*4bfccde5SXin Li            <xsd:documentation>
530*4bfccde5SXin Li                A collection of files that can be downloaded for a given architecture.
531*4bfccde5SXin Li                The &lt;archives&gt; node is mandatory in the repository packages and the
532*4bfccde5SXin Li                collection must have at least one &lt;archive&gt; declared.
533*4bfccde5SXin Li                Each archive is a zip file that will be unzipped in a location that depends
534*4bfccde5SXin Li                on its package type.
535*4bfccde5SXin Li            </xsd:documentation>
536*4bfccde5SXin Li        </xsd:annotation>
537*4bfccde5SXin Li        <xsd:sequence minOccurs="1" maxOccurs="unbounded">
538*4bfccde5SXin Li            <!-- One archive file -->
539*4bfccde5SXin Li            <xsd:element name="archive">
540*4bfccde5SXin Li                <xsd:complexType>
541*4bfccde5SXin Li                    <!-- Properties of the archive file -->
542*4bfccde5SXin Li                    <xsd:all>
543*4bfccde5SXin Li                        <!-- The size in bytes of the archive to download. -->
544*4bfccde5SXin Li                        <xsd:element name="size"     type="xsd:positiveInteger" />
545*4bfccde5SXin Li                        <!-- The checksum of the archive file. -->
546*4bfccde5SXin Li                        <xsd:element name="checksum" type="sdk:checksumType" />
547*4bfccde5SXin Li                        <!-- The URL is an absolute URL if it starts with http://, https://
548*4bfccde5SXin Li                             or ftp://. Otherwise it is relative to the parent directory that
549*4bfccde5SXin Li                             contains this repository.xml -->
550*4bfccde5SXin Li                        <xsd:element name="url"      type="xsd:token" />
551*4bfccde5SXin Li                    </xsd:all>
552*4bfccde5SXin Li
553*4bfccde5SXin Li                    <!-- Attributes that identify the OS and architecture -->
554*4bfccde5SXin Li                    <xsd:attribute name="os" use="required">
555*4bfccde5SXin Li                        <xsd:simpleType>
556*4bfccde5SXin Li                            <xsd:restriction base="xsd:token">
557*4bfccde5SXin Li                                <xsd:enumeration value="any" />
558*4bfccde5SXin Li                                <xsd:enumeration value="linux" />
559*4bfccde5SXin Li                                <xsd:enumeration value="macosx" />
560*4bfccde5SXin Li                                <xsd:enumeration value="windows" />
561*4bfccde5SXin Li                            </xsd:restriction>
562*4bfccde5SXin Li                        </xsd:simpleType>
563*4bfccde5SXin Li                    </xsd:attribute>
564*4bfccde5SXin Li                    <xsd:attribute name="arch" use="optional">
565*4bfccde5SXin Li                        <xsd:simpleType>
566*4bfccde5SXin Li                            <xsd:restriction base="xsd:token">
567*4bfccde5SXin Li                                <xsd:enumeration value="any" />
568*4bfccde5SXin Li                                <xsd:enumeration value="ppc" />
569*4bfccde5SXin Li                                <xsd:enumeration value="x86" />
570*4bfccde5SXin Li                                <xsd:enumeration value="x86_64" />
571*4bfccde5SXin Li                            </xsd:restriction>
572*4bfccde5SXin Li                        </xsd:simpleType>
573*4bfccde5SXin Li                    </xsd:attribute>
574*4bfccde5SXin Li                </xsd:complexType>
575*4bfccde5SXin Li            </xsd:element>
576*4bfccde5SXin Li        </xsd:sequence>
577*4bfccde5SXin Li    </xsd:complexType>
578*4bfccde5SXin Li
579*4bfccde5SXin Li
580*4bfccde5SXin Li    <!-- A collection of file paths available in an &lt;extra&gt; package
581*4bfccde5SXin Li         that can be installed in an Android project.
582*4bfccde5SXin Li         If present, the &lt;project-files&gt; collection must contain at least one path.
583*4bfccde5SXin Li         Each path is relative to the root directory of the package.
584*4bfccde5SXin Li     -->
585*4bfccde5SXin Li
586*4bfccde5SXin Li    <xsd:complexType name="projectFilesType">
587*4bfccde5SXin Li        <xsd:annotation>
588*4bfccde5SXin Li            <xsd:documentation>
589*4bfccde5SXin Li                A collection of file paths available in an &lt;extra&gt; package
590*4bfccde5SXin Li                that can be installed in an Android project.
591*4bfccde5SXin Li                If present, the &lt;project-files&gt; collection must contain at least one path.
592*4bfccde5SXin Li                Each path is relative to the root directory of the package.
593*4bfccde5SXin Li            </xsd:documentation>
594*4bfccde5SXin Li        </xsd:annotation>
595*4bfccde5SXin Li        <xsd:sequence minOccurs="1" maxOccurs="unbounded">
596*4bfccde5SXin Li            <!-- One JAR Path, relative to the root folder of the package. -->
597*4bfccde5SXin Li            <xsd:element name="path" type="xsd:string" />
598*4bfccde5SXin Li        </xsd:sequence>
599*4bfccde5SXin Li    </xsd:complexType>
600*4bfccde5SXin Li
601*4bfccde5SXin Li
602*4bfccde5SXin Li    <!-- The definition of a file checksum -->
603*4bfccde5SXin Li
604*4bfccde5SXin Li    <xsd:simpleType name="sha1Number">
605*4bfccde5SXin Li        <xsd:annotation>
606*4bfccde5SXin Li            <xsd:documentation>A SHA1 checksum.</xsd:documentation>
607*4bfccde5SXin Li        </xsd:annotation>
608*4bfccde5SXin Li        <xsd:restriction base="xsd:string">
609*4bfccde5SXin Li            <xsd:pattern value="([0-9a-fA-F]){40}"/>
610*4bfccde5SXin Li        </xsd:restriction>
611*4bfccde5SXin Li    </xsd:simpleType>
612*4bfccde5SXin Li
613*4bfccde5SXin Li    <xsd:complexType name="checksumType">
614*4bfccde5SXin Li        <xsd:annotation>
615*4bfccde5SXin Li            <xsd:documentation>A file checksum, currently only SHA1.</xsd:documentation>
616*4bfccde5SXin Li        </xsd:annotation>
617*4bfccde5SXin Li        <xsd:simpleContent>
618*4bfccde5SXin Li            <xsd:extension base="sdk:sha1Number">
619*4bfccde5SXin Li                <xsd:attribute name="type" type="xsd:token" fixed="sha1" />
620*4bfccde5SXin Li            </xsd:extension>
621*4bfccde5SXin Li        </xsd:simpleContent>
622*4bfccde5SXin Li    </xsd:complexType>
623*4bfccde5SXin Li
624*4bfccde5SXin Li</xsd:schema>
625