blob: 68c4bd72f194d805941e9c5ccfc7cf08c04dbe94 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
|
/*
* Copyright (C) 2013 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.
*/
package com.android.sdklib.repository.descriptors;
import com.android.annotations.NonNull;
import com.android.sdklib.repository.NoPreviewRevision;
/**
* {@link IPkgDescExtra} keeps information on individual extra SDK packages
* (both local or remote packages definitions.) The base {@link IPkgDesc} tries
* to present a unified interface to package attributes and this interface
* adds methods specific to extras.
* <p/>
* To create a new {@link IPkgDescExtra},
* use {@link PkgDesc.Builder#newExtra(IdDisplay, String, String, String[], NoPreviewRevision)}.
* <p/>
* The extra's revision is a {@link NoPreviewRevision}; the attribute is however
* accessed via {@link IPkgDesc#getFullRevision()} instead of introducing a new
* custom method.
* <p/>
* To query generic packages capabilities, rely on {@link #getType()} and the
* {@code IPkgDesc.hasXxx()} methods provided by {@link IPkgDesc}.
*/
public interface IPkgDescExtra extends IPkgDesc {
/**
* Returns an optional list of older paths for this extra package.
* @return A non-null, possibly empty, for old paths previously used for the same extra.
*/
@NonNull String[] getOldPaths();
/**
* Returns the display name of the Extra.
* @return A non-null name for the Extra, used for display purposes.
*/
@NonNull String getNameDisplay();
}
|
