-
Notifications
You must be signed in to change notification settings - Fork 4.6k
/
NativeBinarySpec.java
149 lines (131 loc) · 5.15 KB
/
NativeBinarySpec.java
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
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
/*
* Copyright 2013 the original author or authors.
*
* 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 org.gradle.nativeplatform;
import org.gradle.api.Incubating;
import org.gradle.internal.HasInternalProtocol;
import org.gradle.nativeplatform.platform.NativePlatform;
import org.gradle.nativeplatform.toolchain.NativeToolChain;
import org.gradle.platform.base.BinarySpec;
import org.gradle.platform.base.Variant;
import java.util.Collection;
/**
* Represents a binary artifact that is the result of building a native component.
*/
@Incubating @HasInternalProtocol
public interface NativeBinarySpec extends BinarySpec {
/**
* The component that this binary was built from.
*/
NativeComponentSpec getComponent();
/**
* The {@link org.gradle.nativeplatform.Flavor} that this binary was built with.
*/
@Variant
Flavor getFlavor();
/**
* Returns the {@link org.gradle.nativeplatform.platform.NativePlatform} that this binary is targeted to run on.
*/
@Variant
NativePlatform getTargetPlatform();
/**
* Returns the {@link org.gradle.nativeplatform.BuildType} used to construct this binary.
*/
@Variant
BuildType getBuildType();
/**
* The libraries that should be linked into this binary.
*/
Collection<NativeDependencySet> getLibs();
/**
* Adds a library as input to this binary.
* <p>
* This method accepts the following types:
*
* <ul>
* <li>A {@link NativeLibrarySpec}</li>
* <li>A {@link NativeDependencySet}</li>
* <li>A {@link java.util.Map} containing the library selector.</li>
* </ul>
*
* The Map notation supports the following String attributes:
*
* <ul>
* <li>project: the path to the project containing the library (optional, defaults to current project)</li>
* <li>library: the name of the library (required)</li>
* <li>linkage: the library linkage required ['shared'/'static'] (optional, defaults to 'shared')</li>
* </ul>
*/
void lib(Object library);
/**
* Returns the {@link org.gradle.nativeplatform.toolchain.NativeToolChain} that will be used to build this binary.
*/
NativeToolChain getToolChain();
// TODO It would be better if these were added via a separate managed view, rather than hard coded.
/**
* The configuration of the linker used when linking this binary.
*
* Valid for {@link SharedLibraryBinarySpec} and {@link NativeExecutableBinarySpec}.
*/
Tool getLinker();
/**
* The configuration of the static library archiver used when creating this binary.
*
* Valid for {@link StaticLibraryBinarySpec}.
*/
Tool getStaticLibArchiver();
/**
* The configuration of the assembler used when compiling assembly sources this binary.
*
* Valid for {@link SharedLibraryBinarySpec}, {@link StaticLibraryBinarySpec} and
* {@link NativeExecutableBinarySpec} when the 'assembler' plugin is applied.
*/
Tool getAssembler();
/**
* The configuration of the C compiler used when compiling C sources for this binary.
*
* Valid for {@link SharedLibraryBinarySpec}, {@link StaticLibraryBinarySpec} and
* {@link NativeExecutableBinarySpec} when the 'c' plugin is applied.
*/
PreprocessingTool getcCompiler();
/**
* The configuration of the C++ compiler used when compiling C++ sources for this binary.
*
* Valid for {@link SharedLibraryBinarySpec}, {@link StaticLibraryBinarySpec} and
* {@link NativeExecutableBinarySpec} when the 'cpp' plugin is applied.
*/
PreprocessingTool getCppCompiler();
/**
* The configuration of the Objective-C compiler used when compiling Objective-C sources for this binary.
*
* Valid for {@link SharedLibraryBinarySpec}, {@link StaticLibraryBinarySpec} and
* {@link NativeExecutableBinarySpec} when the 'objective-c' plugin is applied.
*/
PreprocessingTool getObjcCompiler();
/**
* The configuration of the Objective-C++ compiler used when compiling Objective-C++ sources for this binary.
*
* Valid for {@link SharedLibraryBinarySpec}, {@link StaticLibraryBinarySpec} and
* {@link NativeExecutableBinarySpec} when the 'objective-cpp' plugin is applied.
*/
PreprocessingTool getObjcppCompiler();
/**
* The configuration of the Resource compiler used when compiling resources for this binary.
*
* Valid for {@link SharedLibraryBinarySpec}, {@link StaticLibraryBinarySpec} and
* {@link NativeExecutableBinarySpec} when the 'windows-resources' plugin is applied.
*/
PreprocessingTool getRcCompiler();
}