123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889289028912892289328942895289628972898289929002901290229032904290529062907290829092910291129122913291429152916291729182919292029212922292329242925292629272928292929302931293229332934293529362937293829392940294129422943294429452946294729482949295029512952295329542955295629572958295929602961296229632964296529662967296829692970297129722973297429752976297729782979298029812982298329842985298629872988298929902991299229932994299529962997299829993000300130023003300430053006300730083009301030113012301330143015301630173018301930203021302230233024302530263027302830293030303130323033303430353036303730383039304030413042304330443045304630473048304930503051305230533054305530563057305830593060306130623063306430653066306730683069307030713072307330743075307630773078307930803081308230833084308530863087308830893090309130923093309430953096309730983099310031013102310331043105310631073108310931103111311231133114311531163117311831193120312131223123312431253126312731283129313031313132313331343135313631373138313931403141314231433144314531463147314831493150315131523153315431553156315731583159316031613162316331643165316631673168316931703171317231733174317531763177317831793180318131823183318431853186318731883189319031913192319331943195319631973198319932003201320232033204320532063207320832093210321132123213321432153216321732183219322032213222322332243225322632273228322932303231323232333234323532363237323832393240324132423243324432453246324732483249325032513252325332543255325632573258325932603261326232633264326532663267326832693270327132723273327432753276327732783279328032813282328332843285328632873288328932903291329232933294329532963297329832993300330133023303330433053306330733083309331033113312331333143315331633173318331933203321 |
- // Copyright 2018 Google Inc. All rights reserved.
- //
- // 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 java
- import (
- "fmt"
- "path"
- "path/filepath"
- "reflect"
- "regexp"
- "sort"
- "strings"
- "sync"
- "android/soong/ui/metrics/bp2build_metrics_proto"
- "github.com/google/blueprint"
- "github.com/google/blueprint/proptools"
- "android/soong/android"
- "android/soong/bazel"
- "android/soong/dexpreopt"
- )
- const (
- sdkXmlFileSuffix = ".xml"
- )
- // A tag to associated a dependency with a specific api scope.
- type scopeDependencyTag struct {
- blueprint.BaseDependencyTag
- name string
- apiScope *apiScope
- // Function for extracting appropriate path information from the dependency.
- depInfoExtractor func(paths *scopePaths, ctx android.ModuleContext, dep android.Module) error
- }
- // Extract tag specific information from the dependency.
- func (tag scopeDependencyTag) extractDepInfo(ctx android.ModuleContext, dep android.Module, paths *scopePaths) {
- err := tag.depInfoExtractor(paths, ctx, dep)
- if err != nil {
- ctx.ModuleErrorf("has an invalid {scopeDependencyTag: %s} dependency on module %s: %s", tag.name, ctx.OtherModuleName(dep), err.Error())
- }
- }
- var _ android.ReplaceSourceWithPrebuilt = (*scopeDependencyTag)(nil)
- func (tag scopeDependencyTag) ReplaceSourceWithPrebuilt() bool {
- return false
- }
- // Provides information about an api scope, e.g. public, system, test.
- type apiScope struct {
- // The name of the api scope, e.g. public, system, test
- name string
- // The api scope that this scope extends.
- //
- // This organizes the scopes into an extension hierarchy.
- //
- // If set this means that the API provided by this scope includes the API provided by the scope
- // set in this field.
- extends *apiScope
- // The next api scope that a library that uses this scope can access.
- //
- // This organizes the scopes into an access hierarchy.
- //
- // If set this means that a library that can access this API can also access the API provided by
- // the scope set in this field.
- //
- // A module that sets sdk_version: "<scope>_current" should have access to the <scope> API of
- // every java_sdk_library that it depends on. If the library does not provide an API for <scope>
- // then it will traverse up this access hierarchy to find an API that it does provide.
- //
- // If this is not set then it defaults to the scope set in extends.
- canAccess *apiScope
- // The legacy enabled status for a specific scope can be dependent on other
- // properties that have been specified on the library so it is provided by
- // a function that can determine the status by examining those properties.
- legacyEnabledStatus func(module *SdkLibrary) bool
- // The default enabled status for non-legacy behavior, which is triggered by
- // explicitly enabling at least one api scope.
- defaultEnabledStatus bool
- // Gets a pointer to the scope specific properties.
- scopeSpecificProperties func(module *SdkLibrary) *ApiScopeProperties
- // The name of the field in the dynamically created structure.
- fieldName string
- // The name of the property in the java_sdk_library_import
- propertyName string
- // The tag to use to depend on the stubs library module.
- stubsTag scopeDependencyTag
- // The tag to use to depend on the stubs source module (if separate from the API module).
- stubsSourceTag scopeDependencyTag
- // The tag to use to depend on the API file generating module (if separate from the stubs source module).
- apiFileTag scopeDependencyTag
- // The tag to use to depend on the stubs source and API module.
- stubsSourceAndApiTag scopeDependencyTag
- // The tag to use to depend on the module that provides the latest version of the API .txt file.
- latestApiModuleTag scopeDependencyTag
- // The tag to use to depend on the module that provides the latest version of the API removed.txt
- // file.
- latestRemovedApiModuleTag scopeDependencyTag
- // The scope specific prefix to add to the api file base of "current.txt" or "removed.txt".
- apiFilePrefix string
- // The scope specific suffix to add to the sdk library module name to construct a scope specific
- // module name.
- moduleSuffix string
- // SDK version that the stubs library is built against. Note that this is always
- // *current. Older stubs library built with a numbered SDK version is created from
- // the prebuilt jar.
- sdkVersion string
- // The annotation that identifies this API level, empty for the public API scope.
- annotation string
- // Extra arguments to pass to droidstubs for this scope.
- //
- // This is not used directly but is used to construct the droidstubsArgs.
- extraArgs []string
- // The args that must be passed to droidstubs to generate the API and stubs source
- // for this scope, constructed dynamically by initApiScope().
- //
- // The API only includes the additional members that this scope adds over the scope
- // that it extends.
- //
- // The stubs source must include the definitions of everything that is in this
- // api scope and all the scopes that this one extends.
- droidstubsArgs []string
- // Whether the api scope can be treated as unstable, and should skip compat checks.
- unstable bool
- // Represents the SDK kind of this scope.
- kind android.SdkKind
- }
- // Initialize a scope, creating and adding appropriate dependency tags
- func initApiScope(scope *apiScope) *apiScope {
- name := scope.name
- scopeByName[name] = scope
- allScopeNames = append(allScopeNames, name)
- scope.propertyName = strings.ReplaceAll(name, "-", "_")
- scope.fieldName = proptools.FieldNameForProperty(scope.propertyName)
- scope.stubsTag = scopeDependencyTag{
- name: name + "-stubs",
- apiScope: scope,
- depInfoExtractor: (*scopePaths).extractStubsLibraryInfoFromDependency,
- }
- scope.stubsSourceTag = scopeDependencyTag{
- name: name + "-stubs-source",
- apiScope: scope,
- depInfoExtractor: (*scopePaths).extractStubsSourceInfoFromDep,
- }
- scope.apiFileTag = scopeDependencyTag{
- name: name + "-api",
- apiScope: scope,
- depInfoExtractor: (*scopePaths).extractApiInfoFromDep,
- }
- scope.stubsSourceAndApiTag = scopeDependencyTag{
- name: name + "-stubs-source-and-api",
- apiScope: scope,
- depInfoExtractor: (*scopePaths).extractStubsSourceAndApiInfoFromApiStubsProvider,
- }
- scope.latestApiModuleTag = scopeDependencyTag{
- name: name + "-latest-api",
- apiScope: scope,
- depInfoExtractor: (*scopePaths).extractLatestApiPath,
- }
- scope.latestRemovedApiModuleTag = scopeDependencyTag{
- name: name + "-latest-removed-api",
- apiScope: scope,
- depInfoExtractor: (*scopePaths).extractLatestRemovedApiPath,
- }
- // To get the args needed to generate the stubs source append all the args from
- // this scope and all the scopes it extends as each set of args adds additional
- // members to the stubs.
- var scopeSpecificArgs []string
- if scope.annotation != "" {
- scopeSpecificArgs = []string{"--show-annotation", scope.annotation}
- }
- for s := scope; s != nil; s = s.extends {
- scopeSpecificArgs = append(scopeSpecificArgs, s.extraArgs...)
- // Ensure that the generated stubs includes all the API elements from the API scope
- // that this scope extends.
- if s != scope && s.annotation != "" {
- scopeSpecificArgs = append(scopeSpecificArgs, "--show-for-stub-purposes-annotation", s.annotation)
- }
- }
- // By default, a library that can access a scope can also access the scope it extends.
- if scope.canAccess == nil {
- scope.canAccess = scope.extends
- }
- // Escape any special characters in the arguments. This is needed because droidstubs
- // passes these directly to the shell command.
- scope.droidstubsArgs = proptools.ShellEscapeList(scopeSpecificArgs)
- return scope
- }
- func (scope *apiScope) stubsLibraryModuleNameSuffix() string {
- return ".stubs" + scope.moduleSuffix
- }
- func (scope *apiScope) apiLibraryModuleName(baseName string) string {
- return scope.stubsLibraryModuleName(baseName) + ".from-text"
- }
- func (scope *apiScope) sourceStubLibraryModuleName(baseName string) string {
- return scope.stubsLibraryModuleName(baseName) + ".from-source"
- }
- func (scope *apiScope) stubsLibraryModuleName(baseName string) string {
- return baseName + scope.stubsLibraryModuleNameSuffix()
- }
- func (scope *apiScope) stubsSourceModuleName(baseName string) string {
- return baseName + ".stubs.source" + scope.moduleSuffix
- }
- func (scope *apiScope) apiModuleName(baseName string) string {
- return baseName + ".api" + scope.moduleSuffix
- }
- func (scope *apiScope) String() string {
- return scope.name
- }
- // snapshotRelativeDir returns the snapshot directory into which the files related to scopes will
- // be stored.
- func (scope *apiScope) snapshotRelativeDir() string {
- return filepath.Join("sdk_library", scope.name)
- }
- // snapshotRelativeCurrentApiTxtPath returns the snapshot path to the API .txt file for the named
- // library.
- func (scope *apiScope) snapshotRelativeCurrentApiTxtPath(name string) string {
- return filepath.Join(scope.snapshotRelativeDir(), name+".txt")
- }
- // snapshotRelativeRemovedApiTxtPath returns the snapshot path to the removed API .txt file for the
- // named library.
- func (scope *apiScope) snapshotRelativeRemovedApiTxtPath(name string) string {
- return filepath.Join(scope.snapshotRelativeDir(), name+"-removed.txt")
- }
- type apiScopes []*apiScope
- func (scopes apiScopes) Strings(accessor func(*apiScope) string) []string {
- var list []string
- for _, scope := range scopes {
- list = append(list, accessor(scope))
- }
- return list
- }
- var (
- scopeByName = make(map[string]*apiScope)
- allScopeNames []string
- apiScopePublic = initApiScope(&apiScope{
- name: "public",
- // Public scope is enabled by default for both legacy and non-legacy modes.
- legacyEnabledStatus: func(module *SdkLibrary) bool {
- return true
- },
- defaultEnabledStatus: true,
- scopeSpecificProperties: func(module *SdkLibrary) *ApiScopeProperties {
- return &module.sdkLibraryProperties.Public
- },
- sdkVersion: "current",
- kind: android.SdkPublic,
- })
- apiScopeSystem = initApiScope(&apiScope{
- name: "system",
- extends: apiScopePublic,
- legacyEnabledStatus: (*SdkLibrary).generateTestAndSystemScopesByDefault,
- scopeSpecificProperties: func(module *SdkLibrary) *ApiScopeProperties {
- return &module.sdkLibraryProperties.System
- },
- apiFilePrefix: "system-",
- moduleSuffix: ".system",
- sdkVersion: "system_current",
- annotation: "android.annotation.SystemApi(client=android.annotation.SystemApi.Client.PRIVILEGED_APPS)",
- kind: android.SdkSystem,
- })
- apiScopeTest = initApiScope(&apiScope{
- name: "test",
- extends: apiScopeSystem,
- legacyEnabledStatus: (*SdkLibrary).generateTestAndSystemScopesByDefault,
- scopeSpecificProperties: func(module *SdkLibrary) *ApiScopeProperties {
- return &module.sdkLibraryProperties.Test
- },
- apiFilePrefix: "test-",
- moduleSuffix: ".test",
- sdkVersion: "test_current",
- annotation: "android.annotation.TestApi",
- unstable: true,
- kind: android.SdkTest,
- })
- apiScopeModuleLib = initApiScope(&apiScope{
- name: "module-lib",
- extends: apiScopeSystem,
- // The module-lib scope is disabled by default in legacy mode.
- //
- // Enabling this would break existing usages.
- legacyEnabledStatus: func(module *SdkLibrary) bool {
- return false
- },
- scopeSpecificProperties: func(module *SdkLibrary) *ApiScopeProperties {
- return &module.sdkLibraryProperties.Module_lib
- },
- apiFilePrefix: "module-lib-",
- moduleSuffix: ".module_lib",
- sdkVersion: "module_current",
- annotation: "android.annotation.SystemApi(client=android.annotation.SystemApi.Client.MODULE_LIBRARIES)",
- kind: android.SdkModule,
- })
- apiScopeSystemServer = initApiScope(&apiScope{
- name: "system-server",
- extends: apiScopePublic,
- // The system-server scope can access the module-lib scope.
- //
- // A module that provides a system-server API is appended to the standard bootclasspath that is
- // used by the system server. So, it should be able to access module-lib APIs provided by
- // libraries on the bootclasspath.
- canAccess: apiScopeModuleLib,
- // The system-server scope is disabled by default in legacy mode.
- //
- // Enabling this would break existing usages.
- legacyEnabledStatus: func(module *SdkLibrary) bool {
- return false
- },
- scopeSpecificProperties: func(module *SdkLibrary) *ApiScopeProperties {
- return &module.sdkLibraryProperties.System_server
- },
- apiFilePrefix: "system-server-",
- moduleSuffix: ".system_server",
- sdkVersion: "system_server_current",
- annotation: "android.annotation.SystemApi(client=android.annotation.SystemApi.Client.SYSTEM_SERVER)",
- extraArgs: []string{
- "--hide-annotation", "android.annotation.Hide",
- // com.android.* classes are okay in this interface"
- "--hide", "InternalClasses",
- },
- kind: android.SdkSystemServer,
- })
- allApiScopes = apiScopes{
- apiScopePublic,
- apiScopeSystem,
- apiScopeTest,
- apiScopeModuleLib,
- apiScopeSystemServer,
- }
- )
- var (
- javaSdkLibrariesLock sync.Mutex
- )
- // TODO: these are big features that are currently missing
- // 1) disallowing linking to the runtime shared lib
- // 2) HTML generation
- func init() {
- RegisterSdkLibraryBuildComponents(android.InitRegistrationContext)
- android.RegisterMakeVarsProvider(pctx, func(ctx android.MakeVarsContext) {
- javaSdkLibraries := javaSdkLibraries(ctx.Config())
- sort.Strings(*javaSdkLibraries)
- ctx.Strict("JAVA_SDK_LIBRARIES", strings.Join(*javaSdkLibraries, " "))
- })
- // Register sdk member types.
- android.RegisterSdkMemberType(javaSdkLibrarySdkMemberType)
- }
- func RegisterSdkLibraryBuildComponents(ctx android.RegistrationContext) {
- ctx.RegisterModuleType("java_sdk_library", SdkLibraryFactory)
- ctx.RegisterModuleType("java_sdk_library_import", sdkLibraryImportFactory)
- }
- // Properties associated with each api scope.
- type ApiScopeProperties struct {
- // Indicates whether the api surface is generated.
- //
- // If this is set for any scope then all scopes must explicitly specify if they
- // are enabled. This is to prevent new usages from depending on legacy behavior.
- //
- // Otherwise, if this is not set for any scope then the default behavior is
- // scope specific so please refer to the scope specific property documentation.
- Enabled *bool
- // The sdk_version to use for building the stubs.
- //
- // If not specified then it will use an sdk_version determined as follows:
- //
- // 1) If the sdk_version specified on the java_sdk_library is none then this
- // will be none. This is used for java_sdk_library instances that are used
- // to create stubs that contribute to the core_current sdk version.
- // 2) Otherwise, it is assumed that this library extends but does not
- // contribute directly to a specific sdk_version and so this uses the
- // sdk_version appropriate for the api scope. e.g. public will use
- // sdk_version: current, system will use sdk_version: system_current, etc.
- //
- // This does not affect the sdk_version used for either generating the stubs source
- // or the API file. They both have to use the same sdk_version as is used for
- // compiling the implementation library.
- Sdk_version *string
- }
- type sdkLibraryProperties struct {
- // List of source files that are needed to compile the API, but are not part of runtime library.
- Api_srcs []string `android:"arch_variant"`
- // Visibility for impl library module. If not specified then defaults to the
- // visibility property.
- Impl_library_visibility []string
- // Visibility for stubs library modules. If not specified then defaults to the
- // visibility property.
- Stubs_library_visibility []string
- // Visibility for stubs source modules. If not specified then defaults to the
- // visibility property.
- Stubs_source_visibility []string
- // List of Java libraries that will be in the classpath when building the implementation lib
- Impl_only_libs []string `android:"arch_variant"`
- // List of Java libraries that will included in the implementation lib.
- Impl_only_static_libs []string `android:"arch_variant"`
- // List of Java libraries that will be in the classpath when building stubs
- Stub_only_libs []string `android:"arch_variant"`
- // List of Java libraries that will included in stub libraries
- Stub_only_static_libs []string `android:"arch_variant"`
- // list of package names that will be documented and publicized as API.
- // This allows the API to be restricted to a subset of the source files provided.
- // If this is unspecified then all the source files will be treated as being part
- // of the API.
- Api_packages []string
- // list of package names that must be hidden from the API
- Hidden_api_packages []string
- // the relative path to the directory containing the api specification files.
- // Defaults to "api".
- Api_dir *string
- // Determines whether a runtime implementation library is built; defaults to false.
- //
- // If true then it also prevents the module from being used as a shared module, i.e.
- // it is as if shared_library: false, was set.
- Api_only *bool
- // local files that are used within user customized droiddoc options.
- Droiddoc_option_files []string
- // additional droiddoc options.
- // Available variables for substitution:
- //
- // $(location <label>): the path to the droiddoc_option_files with name <label>
- Droiddoc_options []string
- // is set to true, Metalava will allow framework SDK to contain annotations.
- Annotations_enabled *bool
- // a list of top-level directories containing files to merge qualifier annotations
- // (i.e. those intended to be included in the stubs written) from.
- Merge_annotations_dirs []string
- // a list of top-level directories containing Java stub files to merge show/hide annotations from.
- Merge_inclusion_annotations_dirs []string
- // If set to true then don't create dist rules.
- No_dist *bool
- // The stem for the artifacts that are copied to the dist, if not specified
- // then defaults to the base module name.
- //
- // For each scope the following artifacts are copied to the apistubs/<scope>
- // directory in the dist.
- // * stubs impl jar -> <dist-stem>.jar
- // * API specification file -> api/<dist-stem>.txt
- // * Removed API specification file -> api/<dist-stem>-removed.txt
- //
- // Also used to construct the name of the filegroup (created by prebuilt_apis)
- // that references the latest released API and remove API specification files.
- // * API specification filegroup -> <dist-stem>.api.<scope>.latest
- // * Removed API specification filegroup -> <dist-stem>-removed.api.<scope>.latest
- // * API incompatibilities baseline filegroup -> <dist-stem>-incompatibilities.api.<scope>.latest
- Dist_stem *string
- // The subdirectory for the artifacts that are copied to the dist directory. If not specified
- // then defaults to "unknown". Should be set to "android" for anything that should be published
- // in the public Android SDK.
- Dist_group *string
- // A compatibility mode that allows historical API-tracking files to not exist.
- // Do not use.
- Unsafe_ignore_missing_latest_api bool
- // indicates whether system and test apis should be generated.
- Generate_system_and_test_apis bool `blueprint:"mutated"`
- // The properties specific to the public api scope
- //
- // Unless explicitly specified by using public.enabled the public api scope is
- // enabled by default in both legacy and non-legacy mode.
- Public ApiScopeProperties
- // The properties specific to the system api scope
- //
- // In legacy mode the system api scope is enabled by default when sdk_version
- // is set to something other than "none".
- //
- // In non-legacy mode the system api scope is disabled by default.
- System ApiScopeProperties
- // The properties specific to the test api scope
- //
- // In legacy mode the test api scope is enabled by default when sdk_version
- // is set to something other than "none".
- //
- // In non-legacy mode the test api scope is disabled by default.
- Test ApiScopeProperties
- // The properties specific to the module-lib api scope
- //
- // Unless explicitly specified by using module_lib.enabled the module_lib api
- // scope is disabled by default.
- Module_lib ApiScopeProperties
- // The properties specific to the system-server api scope
- //
- // Unless explicitly specified by using system_server.enabled the
- // system_server api scope is disabled by default.
- System_server ApiScopeProperties
- // Determines if the stubs are preferred over the implementation library
- // for linking, even when the client doesn't specify sdk_version. When this
- // is set to true, such clients are provided with the widest API surface that
- // this lib provides. Note however that this option doesn't affect the clients
- // that are in the same APEX as this library. In that case, the clients are
- // always linked with the implementation library. Default is false.
- Default_to_stubs *bool
- // Properties related to api linting.
- Api_lint struct {
- // Enable api linting.
- Enabled *bool
- }
- // TODO: determines whether to create HTML doc or not
- // Html_doc *bool
- }
- // Paths to outputs from java_sdk_library and java_sdk_library_import.
- //
- // Fields that are android.Paths are always set (during GenerateAndroidBuildActions).
- // OptionalPaths are always set by java_sdk_library but may not be set by
- // java_sdk_library_import as not all instances provide that information.
- type scopePaths struct {
- // The path (represented as Paths for convenience when returning) to the stubs header jar.
- //
- // That is the jar that is created by turbine.
- stubsHeaderPath android.Paths
- // The path (represented as Paths for convenience when returning) to the stubs implementation jar.
- //
- // This is not the implementation jar, it still only contains stubs.
- stubsImplPath android.Paths
- // The dex jar for the stubs.
- //
- // This is not the implementation jar, it still only contains stubs.
- stubsDexJarPath OptionalDexJarPath
- // The API specification file, e.g. system_current.txt.
- currentApiFilePath android.OptionalPath
- // The specification of API elements removed since the last release.
- removedApiFilePath android.OptionalPath
- // The stubs source jar.
- stubsSrcJar android.OptionalPath
- // Extracted annotations.
- annotationsZip android.OptionalPath
- // The path to the latest API file.
- latestApiPath android.OptionalPath
- // The path to the latest removed API file.
- latestRemovedApiPath android.OptionalPath
- }
- func (paths *scopePaths) extractStubsLibraryInfoFromDependency(ctx android.ModuleContext, dep android.Module) error {
- if ctx.OtherModuleHasProvider(dep, JavaInfoProvider) {
- lib := ctx.OtherModuleProvider(dep, JavaInfoProvider).(JavaInfo)
- paths.stubsHeaderPath = lib.HeaderJars
- paths.stubsImplPath = lib.ImplementationJars
- libDep := dep.(UsesLibraryDependency)
- paths.stubsDexJarPath = libDep.DexJarBuildPath()
- return nil
- } else {
- return fmt.Errorf("expected module that has JavaInfoProvider, e.g. java_library")
- }
- }
- func (paths *scopePaths) treatDepAsApiStubsProvider(dep android.Module, action func(provider ApiStubsProvider)) error {
- if apiStubsProvider, ok := dep.(ApiStubsProvider); ok {
- action(apiStubsProvider)
- return nil
- } else {
- return fmt.Errorf("expected module that implements ApiStubsProvider, e.g. droidstubs")
- }
- }
- func (paths *scopePaths) treatDepAsApiStubsSrcProvider(dep android.Module, action func(provider ApiStubsSrcProvider)) error {
- if apiStubsProvider, ok := dep.(ApiStubsSrcProvider); ok {
- action(apiStubsProvider)
- return nil
- } else {
- return fmt.Errorf("expected module that implements ApiStubsSrcProvider, e.g. droidstubs")
- }
- }
- func (paths *scopePaths) extractApiInfoFromApiStubsProvider(provider ApiStubsProvider) {
- paths.annotationsZip = android.OptionalPathForPath(provider.AnnotationsZip())
- paths.currentApiFilePath = android.OptionalPathForPath(provider.ApiFilePath())
- paths.removedApiFilePath = android.OptionalPathForPath(provider.RemovedApiFilePath())
- }
- func (paths *scopePaths) extractApiInfoFromDep(ctx android.ModuleContext, dep android.Module) error {
- return paths.treatDepAsApiStubsProvider(dep, func(provider ApiStubsProvider) {
- paths.extractApiInfoFromApiStubsProvider(provider)
- })
- }
- func (paths *scopePaths) extractStubsSourceInfoFromApiStubsProviders(provider ApiStubsSrcProvider) {
- paths.stubsSrcJar = android.OptionalPathForPath(provider.StubsSrcJar())
- }
- func (paths *scopePaths) extractStubsSourceInfoFromDep(ctx android.ModuleContext, dep android.Module) error {
- return paths.treatDepAsApiStubsSrcProvider(dep, func(provider ApiStubsSrcProvider) {
- paths.extractStubsSourceInfoFromApiStubsProviders(provider)
- })
- }
- func (paths *scopePaths) extractStubsSourceAndApiInfoFromApiStubsProvider(ctx android.ModuleContext, dep android.Module) error {
- return paths.treatDepAsApiStubsProvider(dep, func(provider ApiStubsProvider) {
- paths.extractApiInfoFromApiStubsProvider(provider)
- paths.extractStubsSourceInfoFromApiStubsProviders(provider)
- })
- }
- func extractSingleOptionalOutputPath(dep android.Module) (android.OptionalPath, error) {
- var paths android.Paths
- if sourceFileProducer, ok := dep.(android.SourceFileProducer); ok {
- paths = sourceFileProducer.Srcs()
- } else {
- return android.OptionalPath{}, fmt.Errorf("module %q does not produce source files", dep)
- }
- if len(paths) != 1 {
- return android.OptionalPath{}, fmt.Errorf("expected one path from %q, got %q", dep, paths)
- }
- return android.OptionalPathForPath(paths[0]), nil
- }
- func (paths *scopePaths) extractLatestApiPath(ctx android.ModuleContext, dep android.Module) error {
- outputPath, err := extractSingleOptionalOutputPath(dep)
- paths.latestApiPath = outputPath
- return err
- }
- func (paths *scopePaths) extractLatestRemovedApiPath(ctx android.ModuleContext, dep android.Module) error {
- outputPath, err := extractSingleOptionalOutputPath(dep)
- paths.latestRemovedApiPath = outputPath
- return err
- }
- type commonToSdkLibraryAndImportProperties struct {
- // The naming scheme to use for the components that this module creates.
- //
- // If not specified then it defaults to "default".
- //
- // This is a temporary mechanism to simplify conversion from separate modules for each
- // component that follow a different naming pattern to the default one.
- //
- // TODO(b/155480189) - Remove once naming inconsistencies have been resolved.
- Naming_scheme *string
- // Specifies whether this module can be used as an Android shared library; defaults
- // to true.
- //
- // An Android shared library is one that can be referenced in a <uses-library> element
- // in an AndroidManifest.xml.
- Shared_library *bool
- // Files containing information about supported java doc tags.
- Doctag_files []string `android:"path"`
- // Signals that this shared library is part of the bootclasspath starting
- // on the version indicated in this attribute.
- //
- // This will make platforms at this level and above to ignore
- // <uses-library> tags with this library name because the library is already
- // available
- On_bootclasspath_since *string
- // Signals that this shared library was part of the bootclasspath before
- // (but not including) the version indicated in this attribute.
- //
- // The system will automatically add a <uses-library> tag with this library to
- // apps that target any SDK less than the version indicated in this attribute.
- On_bootclasspath_before *string
- // Indicates that PackageManager should ignore this shared library if the
- // platform is below the version indicated in this attribute.
- //
- // This means that the device won't recognise this library as installed.
- Min_device_sdk *string
- // Indicates that PackageManager should ignore this shared library if the
- // platform is above the version indicated in this attribute.
- //
- // This means that the device won't recognise this library as installed.
- Max_device_sdk *string
- }
- // commonSdkLibraryAndImportModule defines the interface that must be provided by a module that
- // embeds the commonToSdkLibraryAndImport struct.
- type commonSdkLibraryAndImportModule interface {
- android.Module
- BaseModuleName() string
- }
- // Common code between sdk library and sdk library import
- type commonToSdkLibraryAndImport struct {
- module commonSdkLibraryAndImportModule
- scopePaths map[*apiScope]*scopePaths
- namingScheme sdkLibraryComponentNamingScheme
- commonSdkLibraryProperties commonToSdkLibraryAndImportProperties
- // Paths to commonSdkLibraryProperties.Doctag_files
- doctagPaths android.Paths
- // Functionality related to this being used as a component of a java_sdk_library.
- EmbeddableSdkLibraryComponent
- }
- func (c *commonToSdkLibraryAndImport) initCommon(module commonSdkLibraryAndImportModule) {
- c.module = module
- module.AddProperties(&c.commonSdkLibraryProperties)
- // Initialize this as an sdk library component.
- c.initSdkLibraryComponent(module)
- }
- func (c *commonToSdkLibraryAndImport) initCommonAfterDefaultsApplied(ctx android.DefaultableHookContext) bool {
- schemeProperty := proptools.StringDefault(c.commonSdkLibraryProperties.Naming_scheme, "default")
- switch schemeProperty {
- case "default":
- c.namingScheme = &defaultNamingScheme{}
- default:
- ctx.PropertyErrorf("naming_scheme", "expected 'default' but was %q", schemeProperty)
- return false
- }
- namePtr := proptools.StringPtr(c.module.BaseModuleName())
- c.sdkLibraryComponentProperties.SdkLibraryName = namePtr
- // Only track this sdk library if this can be used as a shared library.
- if c.sharedLibrary() {
- // Use the name specified in the module definition as the owner.
- c.sdkLibraryComponentProperties.SdkLibraryToImplicitlyTrack = namePtr
- }
- return true
- }
- // uniqueApexVariations provides common implementation of the ApexModule.UniqueApexVariations
- // method.
- func (c *commonToSdkLibraryAndImport) uniqueApexVariations() bool {
- // A java_sdk_library that is a shared library produces an XML file that makes the shared library
- // usable from an AndroidManifest.xml's <uses-library> entry. That XML file contains the name of
- // the APEX and so it needs a unique variation per APEX.
- return c.sharedLibrary()
- }
- func (c *commonToSdkLibraryAndImport) generateCommonBuildActions(ctx android.ModuleContext) {
- c.doctagPaths = android.PathsForModuleSrc(ctx, c.commonSdkLibraryProperties.Doctag_files)
- }
- // Module name of the runtime implementation library
- func (c *commonToSdkLibraryAndImport) implLibraryModuleName() string {
- return c.module.BaseModuleName() + ".impl"
- }
- // Module name of the XML file for the lib
- func (c *commonToSdkLibraryAndImport) xmlPermissionsModuleName() string {
- return c.module.BaseModuleName() + sdkXmlFileSuffix
- }
- // Name of the java_library module that compiles the stubs source.
- func (c *commonToSdkLibraryAndImport) stubsLibraryModuleName(apiScope *apiScope) string {
- baseName := c.module.BaseModuleName()
- return c.namingScheme.stubsLibraryModuleName(apiScope, baseName)
- }
- // Name of the droidstubs module that generates the stubs source and may also
- // generate/check the API.
- func (c *commonToSdkLibraryAndImport) stubsSourceModuleName(apiScope *apiScope) string {
- baseName := c.module.BaseModuleName()
- return c.namingScheme.stubsSourceModuleName(apiScope, baseName)
- }
- // Name of the java_api_library module that generates the from-text stubs source
- // and compiles to a jar file.
- func (c *commonToSdkLibraryAndImport) apiLibraryModuleName(apiScope *apiScope) string {
- baseName := c.module.BaseModuleName()
- return c.namingScheme.apiLibraryModuleName(apiScope, baseName)
- }
- // Name of the java_library module that compiles the stubs
- // generated from source Java files.
- func (c *commonToSdkLibraryAndImport) sourceStubLibraryModuleName(apiScope *apiScope) string {
- baseName := c.module.BaseModuleName()
- return c.namingScheme.sourceStubLibraryModuleName(apiScope, baseName)
- }
- // The component names for different outputs of the java_sdk_library.
- //
- // They are similar to the names used for the child modules it creates
- const (
- stubsSourceComponentName = "stubs.source"
- apiTxtComponentName = "api.txt"
- removedApiTxtComponentName = "removed-api.txt"
- annotationsComponentName = "annotations.zip"
- )
- // A regular expression to match tags that reference a specific stubs component.
- //
- // It will only match if given a valid scope and a valid component. It is verfy strict
- // to ensure it does not accidentally match a similar looking tag that should be processed
- // by the embedded Library.
- var tagSplitter = func() *regexp.Regexp {
- // Given a list of literal string items returns a regular expression that will
- // match any one of the items.
- choice := func(items ...string) string {
- return `\Q` + strings.Join(items, `\E|\Q`) + `\E`
- }
- // Regular expression to match one of the scopes.
- scopesRegexp := choice(allScopeNames...)
- // Regular expression to match one of the components.
- componentsRegexp := choice(stubsSourceComponentName, apiTxtComponentName, removedApiTxtComponentName, annotationsComponentName)
- // Regular expression to match any combination of one scope and one component.
- return regexp.MustCompile(fmt.Sprintf(`^\.(%s)\.(%s)$`, scopesRegexp, componentsRegexp))
- }()
- // For OutputFileProducer interface
- //
- // .<scope>.<component name>, for all ComponentNames (for example: .public.removed-api.txt)
- func (c *commonToSdkLibraryAndImport) commonOutputFiles(tag string) (android.Paths, error) {
- if groups := tagSplitter.FindStringSubmatch(tag); groups != nil {
- scopeName := groups[1]
- component := groups[2]
- if scope, ok := scopeByName[scopeName]; ok {
- paths := c.findScopePaths(scope)
- if paths == nil {
- return nil, fmt.Errorf("%q does not provide api scope %s", c.module.BaseModuleName(), scopeName)
- }
- switch component {
- case stubsSourceComponentName:
- if paths.stubsSrcJar.Valid() {
- return android.Paths{paths.stubsSrcJar.Path()}, nil
- }
- case apiTxtComponentName:
- if paths.currentApiFilePath.Valid() {
- return android.Paths{paths.currentApiFilePath.Path()}, nil
- }
- case removedApiTxtComponentName:
- if paths.removedApiFilePath.Valid() {
- return android.Paths{paths.removedApiFilePath.Path()}, nil
- }
- case annotationsComponentName:
- if paths.annotationsZip.Valid() {
- return android.Paths{paths.annotationsZip.Path()}, nil
- }
- }
- return nil, fmt.Errorf("%s not available for api scope %s", component, scopeName)
- } else {
- return nil, fmt.Errorf("unknown scope %s in %s", scope, tag)
- }
- } else {
- switch tag {
- case ".doctags":
- if c.doctagPaths != nil {
- return c.doctagPaths, nil
- } else {
- return nil, fmt.Errorf("no doctag_files specified on %s", c.module.BaseModuleName())
- }
- }
- return nil, nil
- }
- }
- func (c *commonToSdkLibraryAndImport) getScopePathsCreateIfNeeded(scope *apiScope) *scopePaths {
- if c.scopePaths == nil {
- c.scopePaths = make(map[*apiScope]*scopePaths)
- }
- paths := c.scopePaths[scope]
- if paths == nil {
- paths = &scopePaths{}
- c.scopePaths[scope] = paths
- }
- return paths
- }
- func (c *commonToSdkLibraryAndImport) findScopePaths(scope *apiScope) *scopePaths {
- if c.scopePaths == nil {
- return nil
- }
- return c.scopePaths[scope]
- }
- // If this does not support the requested api scope then find the closest available
- // scope it does support. Returns nil if no such scope is available.
- func (c *commonToSdkLibraryAndImport) findClosestScopePath(scope *apiScope) *scopePaths {
- for s := scope; s != nil; s = s.canAccess {
- if paths := c.findScopePaths(s); paths != nil {
- return paths
- }
- }
- // This should never happen outside tests as public should be the base scope for every
- // scope and is enabled by default.
- return nil
- }
- func (c *commonToSdkLibraryAndImport) selectHeaderJarsForSdkVersion(ctx android.BaseModuleContext, sdkVersion android.SdkSpec) android.Paths {
- // If a specific numeric version has been requested then use prebuilt versions of the sdk.
- if !sdkVersion.ApiLevel.IsPreview() {
- return PrebuiltJars(ctx, c.module.BaseModuleName(), sdkVersion)
- }
- paths := c.selectScopePaths(ctx, sdkVersion.Kind)
- if paths == nil {
- return nil
- }
- return paths.stubsHeaderPath
- }
- // selectScopePaths returns the *scopePaths appropriate for the specific kind.
- //
- // If the module does not support the specific kind then it will return the *scopePaths for the
- // closest kind which is a subset of the requested kind. e.g. if requesting android.SdkModule then
- // it will return *scopePaths for android.SdkSystem if available or android.SdkPublic of not.
- func (c *commonToSdkLibraryAndImport) selectScopePaths(ctx android.BaseModuleContext, kind android.SdkKind) *scopePaths {
- apiScope := sdkKindToApiScope(kind)
- paths := c.findClosestScopePath(apiScope)
- if paths == nil {
- var scopes []string
- for _, s := range allApiScopes {
- if c.findScopePaths(s) != nil {
- scopes = append(scopes, s.name)
- }
- }
- ctx.ModuleErrorf("requires api scope %s from %s but it only has %q available", apiScope.name, c.module.BaseModuleName(), scopes)
- return nil
- }
- return paths
- }
- // sdkKindToApiScope maps from android.SdkKind to apiScope.
- func sdkKindToApiScope(kind android.SdkKind) *apiScope {
- var apiScope *apiScope
- switch kind {
- case android.SdkSystem:
- apiScope = apiScopeSystem
- case android.SdkModule:
- apiScope = apiScopeModuleLib
- case android.SdkTest:
- apiScope = apiScopeTest
- case android.SdkSystemServer:
- apiScope = apiScopeSystemServer
- default:
- apiScope = apiScopePublic
- }
- return apiScope
- }
- // to satisfy SdkLibraryDependency interface
- func (c *commonToSdkLibraryAndImport) SdkApiStubDexJar(ctx android.BaseModuleContext, kind android.SdkKind) OptionalDexJarPath {
- paths := c.selectScopePaths(ctx, kind)
- if paths == nil {
- return makeUnsetDexJarPath()
- }
- return paths.stubsDexJarPath
- }
- // to satisfy SdkLibraryDependency interface
- func (c *commonToSdkLibraryAndImport) SdkRemovedTxtFile(ctx android.BaseModuleContext, kind android.SdkKind) android.OptionalPath {
- apiScope := sdkKindToApiScope(kind)
- paths := c.findScopePaths(apiScope)
- if paths == nil {
- return android.OptionalPath{}
- }
- return paths.removedApiFilePath
- }
- func (c *commonToSdkLibraryAndImport) sdkComponentPropertiesForChildLibrary() interface{} {
- componentProps := &struct {
- SdkLibraryName *string
- SdkLibraryToImplicitlyTrack *string
- }{}
- namePtr := proptools.StringPtr(c.module.BaseModuleName())
- componentProps.SdkLibraryName = namePtr
- if c.sharedLibrary() {
- // Mark the stubs library as being components of this java_sdk_library so that
- // any app that includes code which depends (directly or indirectly) on the stubs
- // library will have the appropriate <uses-library> invocation inserted into its
- // manifest if necessary.
- componentProps.SdkLibraryToImplicitlyTrack = namePtr
- }
- return componentProps
- }
- func (c *commonToSdkLibraryAndImport) sharedLibrary() bool {
- return proptools.BoolDefault(c.commonSdkLibraryProperties.Shared_library, true)
- }
- // Check if the stub libraries should be compiled for dex
- func (c *commonToSdkLibraryAndImport) stubLibrariesCompiledForDex() bool {
- // Always compile the dex file files for the stub libraries if they will be used on the
- // bootclasspath.
- return !c.sharedLibrary()
- }
- // Properties related to the use of a module as an component of a java_sdk_library.
- type SdkLibraryComponentProperties struct {
- // The name of the java_sdk_library/_import module.
- SdkLibraryName *string `blueprint:"mutated"`
- // The name of the java_sdk_library/_import to add to a <uses-library> entry
- // in the AndroidManifest.xml of any Android app that includes code that references
- // this module. If not set then no java_sdk_library/_import is tracked.
- SdkLibraryToImplicitlyTrack *string `blueprint:"mutated"`
- }
- // Structure to be embedded in a module struct that needs to support the
- // SdkLibraryComponentDependency interface.
- type EmbeddableSdkLibraryComponent struct {
- sdkLibraryComponentProperties SdkLibraryComponentProperties
- }
- func (e *EmbeddableSdkLibraryComponent) initSdkLibraryComponent(module android.Module) {
- module.AddProperties(&e.sdkLibraryComponentProperties)
- }
- // to satisfy SdkLibraryComponentDependency
- func (e *EmbeddableSdkLibraryComponent) SdkLibraryName() *string {
- return e.sdkLibraryComponentProperties.SdkLibraryName
- }
- // to satisfy SdkLibraryComponentDependency
- func (e *EmbeddableSdkLibraryComponent) OptionalSdkLibraryImplementation() *string {
- // For shared libraries, this is the same as the SDK library name. If a Java library or app
- // depends on a component library (e.g. a stub library) it still needs to know the name of the
- // run-time library and the corresponding module that provides the implementation. This name is
- // passed to manifest_fixer (to be added to AndroidManifest.xml) and added to CLC (to be used
- // in dexpreopt).
- //
- // For non-shared SDK (component or not) libraries this returns `nil`, as they are not
- // <uses-library> and should not be added to the manifest or to CLC.
- return e.sdkLibraryComponentProperties.SdkLibraryToImplicitlyTrack
- }
- // Implemented by modules that are (or possibly could be) a component of a java_sdk_library
- // (including the java_sdk_library) itself.
- type SdkLibraryComponentDependency interface {
- UsesLibraryDependency
- // SdkLibraryName returns the name of the java_sdk_library/_import module.
- SdkLibraryName() *string
- // The name of the implementation library for the optional SDK library or nil, if there isn't one.
- OptionalSdkLibraryImplementation() *string
- }
- // Make sure that all the module types that are components of java_sdk_library/_import
- // and which can be referenced (directly or indirectly) from an android app implement
- // the SdkLibraryComponentDependency interface.
- var _ SdkLibraryComponentDependency = (*Library)(nil)
- var _ SdkLibraryComponentDependency = (*Import)(nil)
- var _ SdkLibraryComponentDependency = (*SdkLibrary)(nil)
- var _ SdkLibraryComponentDependency = (*SdkLibraryImport)(nil)
- // Provides access to sdk_version related files, e.g. header and implementation jars.
- type SdkLibraryDependency interface {
- SdkLibraryComponentDependency
- // Get the header jars appropriate for the supplied sdk_version.
- //
- // These are turbine generated jars so they only change if the externals of the
- // class changes but it does not contain and implementation or JavaDoc.
- SdkHeaderJars(ctx android.BaseModuleContext, sdkVersion android.SdkSpec) android.Paths
- // Get the implementation jars appropriate for the supplied sdk version.
- //
- // These are either the implementation jar for the whole sdk library or the implementation
- // jars for the stubs. The latter should only be needed when generating JavaDoc as otherwise
- // they are identical to the corresponding header jars.
- SdkImplementationJars(ctx android.BaseModuleContext, sdkVersion android.SdkSpec) android.Paths
- // SdkApiStubDexJar returns the dex jar for the stubs. It is needed by the hiddenapi processing
- // tool which processes dex files.
- SdkApiStubDexJar(ctx android.BaseModuleContext, kind android.SdkKind) OptionalDexJarPath
- // SdkRemovedTxtFile returns the optional path to the removed.txt file for the specified sdk kind.
- SdkRemovedTxtFile(ctx android.BaseModuleContext, kind android.SdkKind) android.OptionalPath
- // sharedLibrary returns true if this can be used as a shared library.
- sharedLibrary() bool
- }
- type SdkLibrary struct {
- Library
- android.BazelModuleBase
- sdkLibraryProperties sdkLibraryProperties
- // Map from api scope to the scope specific property structure.
- scopeToProperties map[*apiScope]*ApiScopeProperties
- commonToSdkLibraryAndImport
- }
- var _ SdkLibraryDependency = (*SdkLibrary)(nil)
- func (module *SdkLibrary) generateTestAndSystemScopesByDefault() bool {
- return module.sdkLibraryProperties.Generate_system_and_test_apis
- }
- func (module *SdkLibrary) getGeneratedApiScopes(ctx android.EarlyModuleContext) apiScopes {
- // Check to see if any scopes have been explicitly enabled. If any have then all
- // must be.
- anyScopesExplicitlyEnabled := false
- for _, scope := range allApiScopes {
- scopeProperties := module.scopeToProperties[scope]
- if scopeProperties.Enabled != nil {
- anyScopesExplicitlyEnabled = true
- break
- }
- }
- var generatedScopes apiScopes
- enabledScopes := make(map[*apiScope]struct{})
- for _, scope := range allApiScopes {
- scopeProperties := module.scopeToProperties[scope]
- // If any scopes are explicitly enabled then ignore the legacy enabled status.
- // This is to ensure that any new usages of this module type do not rely on legacy
- // behaviour.
- defaultEnabledStatus := false
- if anyScopesExplicitlyEnabled {
- defaultEnabledStatus = scope.defaultEnabledStatus
- } else {
- defaultEnabledStatus = scope.legacyEnabledStatus(module)
- }
- enabled := proptools.BoolDefault(scopeProperties.Enabled, defaultEnabledStatus)
- if enabled {
- enabledScopes[scope] = struct{}{}
- generatedScopes = append(generatedScopes, scope)
- }
- }
- // Now check to make sure that any scope that is extended by an enabled scope is also
- // enabled.
- for _, scope := range allApiScopes {
- if _, ok := enabledScopes[scope]; ok {
- extends := scope.extends
- if extends != nil {
- if _, ok := enabledScopes[extends]; !ok {
- ctx.ModuleErrorf("enabled api scope %q depends on disabled scope %q", scope, extends)
- }
- }
- }
- }
- return generatedScopes
- }
- var _ android.ModuleWithMinSdkVersionCheck = (*SdkLibrary)(nil)
- func (module *SdkLibrary) CheckMinSdkVersion(ctx android.ModuleContext) {
- android.CheckMinSdkVersion(ctx, module.MinSdkVersion(ctx), func(c android.ModuleContext, do android.PayloadDepsCallback) {
- ctx.WalkDeps(func(child android.Module, parent android.Module) bool {
- isExternal := !module.depIsInSameApex(ctx, child)
- if am, ok := child.(android.ApexModule); ok {
- if !do(ctx, parent, am, isExternal) {
- return false
- }
- }
- return !isExternal
- })
- })
- }
- type sdkLibraryComponentTag struct {
- blueprint.BaseDependencyTag
- name string
- }
- // Mark this tag so dependencies that use it are excluded from visibility enforcement.
- func (t sdkLibraryComponentTag) ExcludeFromVisibilityEnforcement() {}
- var xmlPermissionsFileTag = sdkLibraryComponentTag{name: "xml-permissions-file"}
- func IsXmlPermissionsFileDepTag(depTag blueprint.DependencyTag) bool {
- if dt, ok := depTag.(sdkLibraryComponentTag); ok {
- return dt == xmlPermissionsFileTag
- }
- return false
- }
- var implLibraryTag = sdkLibraryComponentTag{name: "impl-library"}
- // Add the dependencies on the child modules in the component deps mutator.
- func (module *SdkLibrary) ComponentDepsMutator(ctx android.BottomUpMutatorContext) {
- for _, apiScope := range module.getGeneratedApiScopes(ctx) {
- // Add dependencies to the stubs library
- stubModuleName := module.stubsLibraryModuleName(apiScope)
- ctx.AddVariationDependencies(nil, apiScope.stubsTag, stubModuleName)
- // Add a dependency on the stubs source in order to access both stubs source and api information.
- ctx.AddVariationDependencies(nil, apiScope.stubsSourceAndApiTag, module.stubsSourceModuleName(apiScope))
- if module.compareAgainstLatestApi(apiScope) {
- // Add dependencies on the latest finalized version of the API .txt file.
- latestApiModuleName := module.latestApiModuleName(apiScope)
- ctx.AddDependency(module, apiScope.latestApiModuleTag, latestApiModuleName)
- // Add dependencies on the latest finalized version of the remove API .txt file.
- latestRemovedApiModuleName := module.latestRemovedApiModuleName(apiScope)
- ctx.AddDependency(module, apiScope.latestRemovedApiModuleTag, latestRemovedApiModuleName)
- }
- }
- if module.requiresRuntimeImplementationLibrary() {
- // Add dependency to the rule for generating the implementation library.
- ctx.AddDependency(module, implLibraryTag, module.implLibraryModuleName())
- if module.sharedLibrary() {
- // Add dependency to the rule for generating the xml permissions file
- ctx.AddDependency(module, xmlPermissionsFileTag, module.xmlPermissionsModuleName())
- }
- }
- }
- // Add other dependencies as normal.
- func (module *SdkLibrary) DepsMutator(ctx android.BottomUpMutatorContext) {
- var missingApiModules []string
- for _, apiScope := range module.getGeneratedApiScopes(ctx) {
- if apiScope.unstable {
- continue
- }
- if m := module.latestApiModuleName(apiScope); !ctx.OtherModuleExists(m) {
- missingApiModules = append(missingApiModules, m)
- }
- if m := module.latestRemovedApiModuleName(apiScope); !ctx.OtherModuleExists(m) {
- missingApiModules = append(missingApiModules, m)
- }
- if m := module.latestIncompatibilitiesModuleName(apiScope); !ctx.OtherModuleExists(m) {
- missingApiModules = append(missingApiModules, m)
- }
- }
- if len(missingApiModules) != 0 && !module.sdkLibraryProperties.Unsafe_ignore_missing_latest_api {
- m := module.Name() + " is missing tracking files for previously released library versions.\n"
- m += "You need to do one of the following:\n"
- m += "- Add `unsafe_ignore_missing_latest_api: true` to your blueprint (to disable compat tracking)\n"
- m += "- Add a set of prebuilt txt files representing the last released version of this library for compat checking.\n"
- m += " (the current set of API files can be used as a seed for this compatibility tracking\n"
- m += "\n"
- m += "The following filegroup modules are missing:\n "
- m += strings.Join(missingApiModules, "\n ") + "\n"
- m += "Please see the documentation of the prebuilt_apis module type (and a usage example in prebuilts/sdk) for a convenient way to generate these."
- ctx.ModuleErrorf(m)
- }
- if module.requiresRuntimeImplementationLibrary() {
- // Only add the deps for the library if it is actually going to be built.
- module.Library.deps(ctx)
- }
- }
- func (module *SdkLibrary) OutputFiles(tag string) (android.Paths, error) {
- paths, err := module.commonOutputFiles(tag)
- if paths != nil || err != nil {
- return paths, err
- }
- if module.requiresRuntimeImplementationLibrary() {
- return module.Library.OutputFiles(tag)
- }
- if tag == "" {
- return nil, nil
- }
- return nil, fmt.Errorf("unsupported module reference tag %q", tag)
- }
- func (module *SdkLibrary) GenerateAndroidBuildActions(ctx android.ModuleContext) {
- if proptools.String(module.deviceProperties.Min_sdk_version) != "" {
- module.CheckMinSdkVersion(ctx)
- }
- module.generateCommonBuildActions(ctx)
- // Only build an implementation library if required.
- if module.requiresRuntimeImplementationLibrary() {
- module.Library.GenerateAndroidBuildActions(ctx)
- }
- // Collate the components exported by this module. All scope specific modules are exported but
- // the impl and xml component modules are not.
- exportedComponents := map[string]struct{}{}
- // Record the paths to the header jars of the library (stubs and impl).
- // When this java_sdk_library is depended upon from others via "libs" property,
- // the recorded paths will be returned depending on the link type of the caller.
- ctx.VisitDirectDeps(func(to android.Module) {
- tag := ctx.OtherModuleDependencyTag(to)
- // Extract information from any of the scope specific dependencies.
- if scopeTag, ok := tag.(scopeDependencyTag); ok {
- apiScope := scopeTag.apiScope
- scopePaths := module.getScopePathsCreateIfNeeded(apiScope)
- // Extract information from the dependency. The exact information extracted
- // is determined by the nature of the dependency which is determined by the tag.
- scopeTag.extractDepInfo(ctx, to, scopePaths)
- exportedComponents[ctx.OtherModuleName(to)] = struct{}{}
- }
- })
- // Make the set of components exported by this module available for use elsewhere.
- exportedComponentInfo := android.ExportedComponentsInfo{Components: android.SortedKeys(exportedComponents)}
- ctx.SetProvider(android.ExportedComponentsInfoProvider, exportedComponentInfo)
- // Provide additional information for inclusion in an sdk's generated .info file.
- additionalSdkInfo := map[string]interface{}{}
- additionalSdkInfo["dist_stem"] = module.distStem()
- baseModuleName := module.distStem()
- scopes := map[string]interface{}{}
- additionalSdkInfo["scopes"] = scopes
- for scope, scopePaths := range module.scopePaths {
- scopeInfo := map[string]interface{}{}
- scopes[scope.name] = scopeInfo
- scopeInfo["current_api"] = scope.snapshotRelativeCurrentApiTxtPath(baseModuleName)
- scopeInfo["removed_api"] = scope.snapshotRelativeRemovedApiTxtPath(baseModuleName)
- if p := scopePaths.latestApiPath; p.Valid() {
- scopeInfo["latest_api"] = p.Path().String()
- }
- if p := scopePaths.latestRemovedApiPath; p.Valid() {
- scopeInfo["latest_removed_api"] = p.Path().String()
- }
- }
- ctx.SetProvider(android.AdditionalSdkInfoProvider, android.AdditionalSdkInfo{additionalSdkInfo})
- }
- func (module *SdkLibrary) AndroidMkEntries() []android.AndroidMkEntries {
- if !module.requiresRuntimeImplementationLibrary() {
- return nil
- }
- entriesList := module.Library.AndroidMkEntries()
- if module.sharedLibrary() {
- entries := &entriesList[0]
- entries.Required = append(entries.Required, module.xmlPermissionsModuleName())
- }
- return entriesList
- }
- // The dist path of the stub artifacts
- func (module *SdkLibrary) apiDistPath(apiScope *apiScope) string {
- return path.Join("apistubs", module.distGroup(), apiScope.name)
- }
- // Get the sdk version for use when compiling the stubs library.
- func (module *SdkLibrary) sdkVersionForStubsLibrary(mctx android.EarlyModuleContext, apiScope *apiScope) string {
- scopeProperties := module.scopeToProperties[apiScope]
- if scopeProperties.Sdk_version != nil {
- return proptools.String(scopeProperties.Sdk_version)
- }
- sdkDep := decodeSdkDep(mctx, android.SdkContext(&module.Library))
- if sdkDep.hasStandardLibs() {
- // If building against a standard sdk then use the sdk version appropriate for the scope.
- return apiScope.sdkVersion
- } else {
- // Otherwise, use no system module.
- return "none"
- }
- }
- func (module *SdkLibrary) distStem() string {
- return proptools.StringDefault(module.sdkLibraryProperties.Dist_stem, module.BaseModuleName())
- }
- // distGroup returns the subdirectory of the dist path of the stub artifacts.
- func (module *SdkLibrary) distGroup() string {
- return proptools.StringDefault(module.sdkLibraryProperties.Dist_group, "unknown")
- }
- func latestPrebuiltApiModuleName(name string, apiScope *apiScope) string {
- return PrebuiltApiModuleName(name, apiScope.name, "latest")
- }
- func (module *SdkLibrary) latestApiFilegroupName(apiScope *apiScope) string {
- return ":" + module.latestApiModuleName(apiScope)
- }
- func (module *SdkLibrary) latestApiModuleName(apiScope *apiScope) string {
- return latestPrebuiltApiModuleName(module.distStem(), apiScope)
- }
- func (module *SdkLibrary) latestRemovedApiFilegroupName(apiScope *apiScope) string {
- return ":" + module.latestRemovedApiModuleName(apiScope)
- }
- func (module *SdkLibrary) latestRemovedApiModuleName(apiScope *apiScope) string {
- return latestPrebuiltApiModuleName(module.distStem()+"-removed", apiScope)
- }
- func (module *SdkLibrary) latestIncompatibilitiesFilegroupName(apiScope *apiScope) string {
- return ":" + module.latestIncompatibilitiesModuleName(apiScope)
- }
- func (module *SdkLibrary) latestIncompatibilitiesModuleName(apiScope *apiScope) string {
- return latestPrebuiltApiModuleName(module.distStem()+"-incompatibilities", apiScope)
- }
- func (module *SdkLibrary) contributesToApiSurface(c android.Config) bool {
- _, exists := c.GetApiLibraries()[module.Name()]
- return exists
- }
- func childModuleVisibility(childVisibility []string) []string {
- if childVisibility == nil {
- // No child visibility set. The child will use the visibility of the sdk_library.
- return nil
- }
- // Prepend an override to ignore the sdk_library's visibility, and rely on the child visibility.
- var visibility []string
- visibility = append(visibility, "//visibility:override")
- visibility = append(visibility, childVisibility...)
- return visibility
- }
- // Creates the implementation java library
- func (module *SdkLibrary) createImplLibrary(mctx android.DefaultableHookContext) {
- visibility := childModuleVisibility(module.sdkLibraryProperties.Impl_library_visibility)
- props := struct {
- Name *string
- Visibility []string
- Instrument bool
- Libs []string
- Static_libs []string
- Apex_available []string
- }{
- Name: proptools.StringPtr(module.implLibraryModuleName()),
- Visibility: visibility,
- // Set the instrument property to ensure it is instrumented when instrumentation is required.
- Instrument: true,
- // Set the impl_only libs. Note that the module's "Libs" get appended as well, via the
- // addition of &module.properties below.
- Libs: module.sdkLibraryProperties.Impl_only_libs,
- // Set the impl_only static libs. Note that the module's "static_libs" get appended as well, via the
- // addition of &module.properties below.
- Static_libs: module.sdkLibraryProperties.Impl_only_static_libs,
- // Pass the apex_available settings down so that the impl library can be statically
- // embedded within a library that is added to an APEX. Needed for updatable-media.
- Apex_available: module.ApexAvailable(),
- }
- properties := []interface{}{
- &module.properties,
- &module.protoProperties,
- &module.deviceProperties,
- &module.dexProperties,
- &module.dexpreoptProperties,
- &module.linter.properties,
- &props,
- module.sdkComponentPropertiesForChildLibrary(),
- }
- mctx.CreateModule(LibraryFactory, properties...)
- }
- // Creates a static java library that has API stubs
- func (module *SdkLibrary) createStubsLibrary(mctx android.DefaultableHookContext, apiScope *apiScope) {
- props := struct {
- Name *string
- Visibility []string
- Srcs []string
- Installable *bool
- Sdk_version *string
- System_modules *string
- Patch_module *string
- Libs []string
- Static_libs []string
- Compile_dex *bool
- Java_version *string
- Openjdk9 struct {
- Srcs []string
- Javacflags []string
- }
- Dist struct {
- Targets []string
- Dest *string
- Dir *string
- Tag *string
- }
- }{}
- props.Name = proptools.StringPtr(module.sourceStubLibraryModuleName(apiScope))
- props.Visibility = childModuleVisibility(module.sdkLibraryProperties.Stubs_library_visibility)
- // sources are generated from the droiddoc
- props.Srcs = []string{":" + module.stubsSourceModuleName(apiScope)}
- sdkVersion := module.sdkVersionForStubsLibrary(mctx, apiScope)
- props.Sdk_version = proptools.StringPtr(sdkVersion)
- props.System_modules = module.deviceProperties.System_modules
- props.Patch_module = module.properties.Patch_module
- props.Installable = proptools.BoolPtr(false)
- props.Libs = module.sdkLibraryProperties.Stub_only_libs
- props.Static_libs = module.sdkLibraryProperties.Stub_only_static_libs
- // The stub-annotations library contains special versions of the annotations
- // with CLASS retention policy, so that they're kept.
- if proptools.Bool(module.sdkLibraryProperties.Annotations_enabled) {
- props.Libs = append(props.Libs, "stub-annotations")
- }
- props.Openjdk9.Srcs = module.properties.Openjdk9.Srcs
- props.Openjdk9.Javacflags = module.properties.Openjdk9.Javacflags
- // We compile the stubs for 1.8 in line with the main android.jar stubs, and potential
- // interop with older developer tools that don't support 1.9.
- props.Java_version = proptools.StringPtr("1.8")
- mctx.CreateModule(LibraryFactory, &props, module.sdkComponentPropertiesForChildLibrary())
- }
- // Creates a droidstubs module that creates stubs source files from the given full source
- // files and also updates and checks the API specification files.
- func (module *SdkLibrary) createStubsSourcesAndApi(mctx android.DefaultableHookContext, apiScope *apiScope, name string, scopeSpecificDroidstubsArgs []string) {
- props := struct {
- Name *string
- Visibility []string
- Srcs []string
- Installable *bool
- Sdk_version *string
- Api_surface *string
- System_modules *string
- Libs []string
- Output_javadoc_comments *bool
- Arg_files []string
- Args *string
- Java_version *string
- Annotations_enabled *bool
- Merge_annotations_dirs []string
- Merge_inclusion_annotations_dirs []string
- Generate_stubs *bool
- Previous_api *string
- Check_api struct {
- Current ApiToCheck
- Last_released ApiToCheck
- Api_lint struct {
- Enabled *bool
- New_since *string
- Baseline_file *string
- }
- }
- Aidl struct {
- Include_dirs []string
- Local_include_dirs []string
- }
- Dists []android.Dist
- }{}
- // The stubs source processing uses the same compile time classpath when extracting the
- // API from the implementation library as it does when compiling it. i.e. the same
- // * sdk version
- // * system_modules
- // * libs (static_libs/libs)
- props.Name = proptools.StringPtr(name)
- props.Visibility = childModuleVisibility(module.sdkLibraryProperties.Stubs_source_visibility)
- props.Srcs = append(props.Srcs, module.properties.Srcs...)
- props.Srcs = append(props.Srcs, module.sdkLibraryProperties.Api_srcs...)
- props.Sdk_version = module.deviceProperties.Sdk_version
- props.Api_surface = &apiScope.name
- props.System_modules = module.deviceProperties.System_modules
- props.Installable = proptools.BoolPtr(false)
- // A droiddoc module has only one Libs property and doesn't distinguish between
- // shared libs and static libs. So we need to add both of these libs to Libs property.
- props.Libs = module.properties.Libs
- props.Libs = append(props.Libs, module.properties.Static_libs...)
- props.Libs = append(props.Libs, module.sdkLibraryProperties.Stub_only_libs...)
- props.Aidl.Include_dirs = module.deviceProperties.Aidl.Include_dirs
- props.Aidl.Local_include_dirs = module.deviceProperties.Aidl.Local_include_dirs
- props.Java_version = module.properties.Java_version
- props.Annotations_enabled = module.sdkLibraryProperties.Annotations_enabled
- props.Merge_annotations_dirs = module.sdkLibraryProperties.Merge_annotations_dirs
- props.Merge_inclusion_annotations_dirs = module.sdkLibraryProperties.Merge_inclusion_annotations_dirs
- droidstubsArgs := []string{}
- if len(module.sdkLibraryProperties.Api_packages) != 0 {
- droidstubsArgs = append(droidstubsArgs, "--stub-packages "+strings.Join(module.sdkLibraryProperties.Api_packages, ":"))
- }
- if len(module.sdkLibraryProperties.Hidden_api_packages) != 0 {
- droidstubsArgs = append(droidstubsArgs,
- android.JoinWithPrefix(module.sdkLibraryProperties.Hidden_api_packages, " --hide-package "))
- }
- droidstubsArgs = append(droidstubsArgs, module.sdkLibraryProperties.Droiddoc_options...)
- disabledWarnings := []string{
- "BroadcastBehavior",
- "DeprecationMismatch",
- "HiddenSuperclass",
- "HiddenTypeParameter",
- "MissingPermission",
- "SdkConstant",
- "Todo",
- "UnavailableSymbol",
- }
- droidstubsArgs = append(droidstubsArgs, android.JoinWithPrefix(disabledWarnings, "--hide "))
- // Output Javadoc comments for public scope.
- if apiScope == apiScopePublic {
- props.Output_javadoc_comments = proptools.BoolPtr(true)
- }
- // Add in scope specific arguments.
- droidstubsArgs = append(droidstubsArgs, scopeSpecificDroidstubsArgs...)
- props.Arg_files = module.sdkLibraryProperties.Droiddoc_option_files
- props.Args = proptools.StringPtr(strings.Join(droidstubsArgs, " "))
- // List of APIs identified from the provided source files are created. They are later
- // compared against to the not-yet-released (a.k.a current) list of APIs and to the
- // last-released (a.k.a numbered) list of API.
- currentApiFileName := apiScope.apiFilePrefix + "current.txt"
- removedApiFileName := apiScope.apiFilePrefix + "removed.txt"
- apiDir := module.getApiDir()
- currentApiFileName = path.Join(apiDir, currentApiFileName)
- removedApiFileName = path.Join(apiDir, removedApiFileName)
- // check against the not-yet-release API
- props.Check_api.Current.Api_file = proptools.StringPtr(currentApiFileName)
- props.Check_api.Current.Removed_api_file = proptools.StringPtr(removedApiFileName)
- if module.compareAgainstLatestApi(apiScope) {
- // check against the latest released API
- latestApiFilegroupName := proptools.StringPtr(module.latestApiFilegroupName(apiScope))
- props.Previous_api = latestApiFilegroupName
- props.Check_api.Last_released.Api_file = latestApiFilegroupName
- props.Check_api.Last_released.Removed_api_file = proptools.StringPtr(
- module.latestRemovedApiFilegroupName(apiScope))
- props.Check_api.Last_released.Baseline_file = proptools.StringPtr(
- module.latestIncompatibilitiesFilegroupName(apiScope))
- if proptools.Bool(module.sdkLibraryProperties.Api_lint.Enabled) {
- // Enable api lint.
- props.Check_api.Api_lint.Enabled = proptools.BoolPtr(true)
- props.Check_api.Api_lint.New_since = latestApiFilegroupName
- // If it exists then pass a lint-baseline.txt through to droidstubs.
- baselinePath := path.Join(apiDir, apiScope.apiFilePrefix+"lint-baseline.txt")
- baselinePathRelativeToRoot := path.Join(mctx.ModuleDir(), baselinePath)
- paths, err := mctx.GlobWithDeps(baselinePathRelativeToRoot, nil)
- if err != nil {
- mctx.ModuleErrorf("error checking for presence of %s: %s", baselinePathRelativeToRoot, err)
- }
- if len(paths) == 1 {
- props.Check_api.Api_lint.Baseline_file = proptools.StringPtr(baselinePath)
- } else if len(paths) != 0 {
- mctx.ModuleErrorf("error checking for presence of %s: expected one path, found: %v", baselinePathRelativeToRoot, paths)
- }
- }
- }
- if !Bool(module.sdkLibraryProperties.No_dist) {
- // Dist the api txt and removed api txt artifacts for sdk builds.
- distDir := proptools.StringPtr(path.Join(module.apiDistPath(apiScope), "api"))
- for _, p := range []struct {
- tag string
- pattern string
- }{
- {tag: ".api.txt", pattern: "%s.txt"},
- {tag: ".removed-api.txt", pattern: "%s-removed.txt"},
- } {
- props.Dists = append(props.Dists, android.Dist{
- Targets: []string{"sdk", "win_sdk"},
- Dir: distDir,
- Dest: proptools.StringPtr(fmt.Sprintf(p.pattern, module.distStem())),
- Tag: proptools.StringPtr(p.tag),
- })
- }
- }
- mctx.CreateModule(DroidstubsFactory, &props).(*Droidstubs).CallHookIfAvailable(mctx)
- }
- func (module *SdkLibrary) createApiLibrary(mctx android.DefaultableHookContext, apiScope *apiScope) {
- props := struct {
- Name *string
- Visibility []string
- Api_contributions []string
- Libs []string
- Static_libs []string
- Full_api_surface_stub *string
- }{}
- props.Name = proptools.StringPtr(module.apiLibraryModuleName(apiScope))
- props.Visibility = childModuleVisibility(module.sdkLibraryProperties.Stubs_library_visibility)
- apiContributions := []string{}
- // Api surfaces are not independent of each other, but have subset relationships,
- // and so does the api files. To generate from-text stubs for api surfaces other than public,
- // all subset api domains' api_contriubtions must be added as well.
- scope := apiScope
- for scope != nil {
- apiContributions = append(apiContributions, module.stubsSourceModuleName(scope)+".api.contribution")
- scope = scope.extends
- }
- props.Api_contributions = apiContributions
- props.Libs = module.properties.Libs
- props.Libs = append(props.Libs, module.sdkLibraryProperties.Stub_only_libs...)
- props.Libs = append(props.Libs, "stub-annotations")
- props.Static_libs = module.sdkLibraryProperties.Stub_only_static_libs
- props.Full_api_surface_stub = proptools.StringPtr(apiScope.kind.DefaultJavaLibraryName() + ".from-text")
- // android_module_lib_stubs_current.from-text only comprises api contributions from art, conscrypt and i18n.
- // Thus, replace with android_module_lib_stubs_current_full.from-text, which comprises every api domains.
- if apiScope.kind == android.SdkModule {
- props.Full_api_surface_stub = proptools.StringPtr(apiScope.kind.DefaultJavaLibraryName() + "_full.from-text")
- }
- mctx.CreateModule(ApiLibraryFactory, &props)
- }
- func (module *SdkLibrary) createTopLevelStubsLibrary(
- mctx android.DefaultableHookContext, apiScope *apiScope, contributesToApiSurface bool) {
- props := struct {
- Name *string
- Visibility []string
- Sdk_version *string
- Static_libs []string
- System_modules *string
- Dist struct {
- Targets []string
- Dest *string
- Dir *string
- Tag *string
- }
- Compile_dex *bool
- }{}
- props.Name = proptools.StringPtr(module.stubsLibraryModuleName(apiScope))
- props.Visibility = childModuleVisibility(module.sdkLibraryProperties.Stubs_library_visibility)
- sdkVersion := module.sdkVersionForStubsLibrary(mctx, apiScope)
- props.Sdk_version = proptools.StringPtr(sdkVersion)
- // Add the stub compiling java_library/java_api_library as static lib based on build config
- staticLib := module.sourceStubLibraryModuleName(apiScope)
- if mctx.Config().BuildFromTextStub() && contributesToApiSurface {
- staticLib = module.apiLibraryModuleName(apiScope)
- }
- props.Static_libs = append(props.Static_libs, staticLib)
- props.System_modules = module.deviceProperties.System_modules
- // Dist the class jar artifact for sdk builds.
- if !Bool(module.sdkLibraryProperties.No_dist) {
- props.Dist.Targets = []string{"sdk", "win_sdk"}
- props.Dist.Dest = proptools.StringPtr(fmt.Sprintf("%v.jar", module.distStem()))
- props.Dist.Dir = proptools.StringPtr(module.apiDistPath(apiScope))
- props.Dist.Tag = proptools.StringPtr(".jar")
- }
- // The imports need to be compiled to dex if the java_sdk_library requests it.
- compileDex := module.dexProperties.Compile_dex
- if module.stubLibrariesCompiledForDex() {
- compileDex = proptools.BoolPtr(true)
- }
- props.Compile_dex = compileDex
- mctx.CreateModule(LibraryFactory, &props, module.sdkComponentPropertiesForChildLibrary())
- }
- func (module *SdkLibrary) compareAgainstLatestApi(apiScope *apiScope) bool {
- return !(apiScope.unstable || module.sdkLibraryProperties.Unsafe_ignore_missing_latest_api)
- }
- // Implements android.ApexModule
- func (module *SdkLibrary) DepIsInSameApex(mctx android.BaseModuleContext, dep android.Module) bool {
- depTag := mctx.OtherModuleDependencyTag(dep)
- if depTag == xmlPermissionsFileTag {
- return true
- }
- return module.Library.DepIsInSameApex(mctx, dep)
- }
- // Implements android.ApexModule
- func (module *SdkLibrary) UniqueApexVariations() bool {
- return module.uniqueApexVariations()
- }
- // Creates the xml file that publicizes the runtime library
- func (module *SdkLibrary) createXmlFile(mctx android.DefaultableHookContext) {
- moduleMinApiLevel := module.Library.MinSdkVersion(mctx)
- var moduleMinApiLevelStr = moduleMinApiLevel.String()
- if moduleMinApiLevel == android.NoneApiLevel {
- moduleMinApiLevelStr = "current"
- }
- props := struct {
- Name *string
- Lib_name *string
- Apex_available []string
- On_bootclasspath_since *string
- On_bootclasspath_before *string
- Min_device_sdk *string
- Max_device_sdk *string
- Sdk_library_min_api_level *string
- }{
- Name: proptools.StringPtr(module.xmlPermissionsModuleName()),
- Lib_name: proptools.StringPtr(module.BaseModuleName()),
- Apex_available: module.ApexProperties.Apex_available,
- On_bootclasspath_since: module.commonSdkLibraryProperties.On_bootclasspath_since,
- On_bootclasspath_before: module.commonSdkLibraryProperties.On_bootclasspath_before,
- Min_device_sdk: module.commonSdkLibraryProperties.Min_device_sdk,
- Max_device_sdk: module.commonSdkLibraryProperties.Max_device_sdk,
- Sdk_library_min_api_level: &moduleMinApiLevelStr,
- }
- mctx.CreateModule(sdkLibraryXmlFactory, &props)
- }
- func PrebuiltJars(ctx android.BaseModuleContext, baseName string, s android.SdkSpec) android.Paths {
- var ver android.ApiLevel
- var kind android.SdkKind
- if s.UsePrebuilt(ctx) {
- ver = s.ApiLevel
- kind = s.Kind
- } else {
- // We don't have prebuilt SDK for the specific sdkVersion.
- // Instead of breaking the build, fallback to use "system_current"
- ver = android.FutureApiLevel
- kind = android.SdkSystem
- }
- dir := filepath.Join("prebuilts", "sdk", ver.String(), kind.String())
- jar := filepath.Join(dir, baseName+".jar")
- jarPath := android.ExistentPathForSource(ctx, jar)
- if !jarPath.Valid() {
- if ctx.Config().AllowMissingDependencies() {
- return android.Paths{android.PathForSource(ctx, jar)}
- } else {
- ctx.PropertyErrorf("sdk_library", "invalid sdk version %q, %q does not exist", s.Raw, jar)
- }
- return nil
- }
- return android.Paths{jarPath.Path()}
- }
- // Check to see if the other module is within the same set of named APEXes as this module.
- //
- // If either this or the other module are on the platform then this will return
- // false.
- func withinSameApexesAs(ctx android.BaseModuleContext, other android.Module) bool {
- apexInfo := ctx.Provider(android.ApexInfoProvider).(android.ApexInfo)
- otherApexInfo := ctx.OtherModuleProvider(other, android.ApexInfoProvider).(android.ApexInfo)
- return len(otherApexInfo.InApexVariants) > 0 && reflect.DeepEqual(apexInfo.InApexVariants, otherApexInfo.InApexVariants)
- }
- func (module *SdkLibrary) sdkJars(ctx android.BaseModuleContext, sdkVersion android.SdkSpec, headerJars bool) android.Paths {
- // If the client doesn't set sdk_version, but if this library prefers stubs over
- // the impl library, let's provide the widest API surface possible. To do so,
- // force override sdk_version to module_current so that the closest possible API
- // surface could be found in selectHeaderJarsForSdkVersion
- if module.defaultsToStubs() && !sdkVersion.Specified() {
- sdkVersion = android.SdkSpecFrom(ctx, "module_current")
- }
- // Only provide access to the implementation library if it is actually built.
- if module.requiresRuntimeImplementationLibrary() {
- // Check any special cases for java_sdk_library.
- //
- // Only allow access to the implementation library in the following condition:
- // * No sdk_version specified on the referencing module.
- // * The referencing module is in the same apex as this.
- if sdkVersion.Kind == android.SdkPrivate || withinSameApexesAs(ctx, module) {
- if headerJars {
- return module.HeaderJars()
- } else {
- return module.ImplementationJars()
- }
- }
- }
- return module.selectHeaderJarsForSdkVersion(ctx, sdkVersion)
- }
- // to satisfy SdkLibraryDependency interface
- func (module *SdkLibrary) SdkHeaderJars(ctx android.BaseModuleContext, sdkVersion android.SdkSpec) android.Paths {
- return module.sdkJars(ctx, sdkVersion, true /*headerJars*/)
- }
- // to satisfy SdkLibraryDependency interface
- func (module *SdkLibrary) SdkImplementationJars(ctx android.BaseModuleContext, sdkVersion android.SdkSpec) android.Paths {
- return module.sdkJars(ctx, sdkVersion, false /*headerJars*/)
- }
- var javaSdkLibrariesKey = android.NewOnceKey("javaSdkLibraries")
- func javaSdkLibraries(config android.Config) *[]string {
- return config.Once(javaSdkLibrariesKey, func() interface{} {
- return &[]string{}
- }).(*[]string)
- }
- func (module *SdkLibrary) getApiDir() string {
- return proptools.StringDefault(module.sdkLibraryProperties.Api_dir, "api")
- }
- // For a java_sdk_library module, create internal modules for stubs, docs,
- // runtime libs and xml file. If requested, the stubs and docs are created twice
- // once for public API level and once for system API level
- func (module *SdkLibrary) CreateInternalModules(mctx android.DefaultableHookContext) {
- // If the module has been disabled then don't create any child modules.
- if !module.Enabled() {
- return
- }
- if len(module.properties.Srcs) == 0 {
- mctx.PropertyErrorf("srcs", "java_sdk_library must specify srcs")
- return
- }
- // If this builds against standard libraries (i.e. is not part of the core libraries)
- // then assume it provides both system and test apis.
- sdkDep := decodeSdkDep(mctx, android.SdkContext(&module.Library))
- hasSystemAndTestApis := sdkDep.hasStandardLibs()
- module.sdkLibraryProperties.Generate_system_and_test_apis = hasSystemAndTestApis
- missingCurrentApi := false
- generatedScopes := module.getGeneratedApiScopes(mctx)
- apiDir := module.getApiDir()
- for _, scope := range generatedScopes {
- for _, api := range []string{"current.txt", "removed.txt"} {
- path := path.Join(mctx.ModuleDir(), apiDir, scope.apiFilePrefix+api)
- p := android.ExistentPathForSource(mctx, path)
- if !p.Valid() {
- if mctx.Config().AllowMissingDependencies() {
- mctx.AddMissingDependencies([]string{path})
- } else {
- mctx.ModuleErrorf("Current api file %#v doesn't exist", path)
- missingCurrentApi = true
- }
- }
- }
- }
- if missingCurrentApi {
- script := "build/soong/scripts/gen-java-current-api-files.sh"
- p := android.ExistentPathForSource(mctx, script)
- if !p.Valid() {
- panic(fmt.Sprintf("script file %s doesn't exist", script))
- }
- mctx.ModuleErrorf("One or more current api files are missing. "+
- "You can update them by:\n"+
- "%s %q %s && m update-api",
- script, filepath.Join(mctx.ModuleDir(), apiDir),
- strings.Join(generatedScopes.Strings(func(s *apiScope) string { return s.apiFilePrefix }), " "))
- return
- }
- for _, scope := range generatedScopes {
- // Use the stubs source name for legacy reasons.
- module.createStubsSourcesAndApi(mctx, scope, module.stubsSourceModuleName(scope), scope.droidstubsArgs)
- module.createStubsLibrary(mctx, scope)
- contributesToApiSurface := module.contributesToApiSurface(mctx.Config())
- if contributesToApiSurface {
- module.createApiLibrary(mctx, scope)
- }
- module.createTopLevelStubsLibrary(mctx, scope, contributesToApiSurface)
- }
- if module.requiresRuntimeImplementationLibrary() {
- // Create child module to create an implementation library.
- //
- // This temporarily creates a second implementation library that can be explicitly
- // referenced.
- //
- // TODO(b/156618935) - update comment once only one implementation library is created.
- module.createImplLibrary(mctx)
- // Only create an XML permissions file that declares the library as being usable
- // as a shared library if required.
- if module.sharedLibrary() {
- module.createXmlFile(mctx)
- }
- // record java_sdk_library modules so that they are exported to make
- javaSdkLibraries := javaSdkLibraries(mctx.Config())
- javaSdkLibrariesLock.Lock()
- defer javaSdkLibrariesLock.Unlock()
- *javaSdkLibraries = append(*javaSdkLibraries, module.BaseModuleName())
- }
- // Add the impl_only_libs and impl_only_static_libs *after* we're done using them in submodules.
- module.properties.Libs = append(module.properties.Libs, module.sdkLibraryProperties.Impl_only_libs...)
- module.properties.Static_libs = append(module.properties.Static_libs, module.sdkLibraryProperties.Impl_only_static_libs...)
- }
- func (module *SdkLibrary) InitSdkLibraryProperties() {
- module.addHostAndDeviceProperties()
- module.AddProperties(&module.sdkLibraryProperties)
- module.initSdkLibraryComponent(module)
- module.properties.Installable = proptools.BoolPtr(true)
- module.deviceProperties.IsSDKLibrary = true
- }
- func (module *SdkLibrary) requiresRuntimeImplementationLibrary() bool {
- return !proptools.Bool(module.sdkLibraryProperties.Api_only)
- }
- func (module *SdkLibrary) defaultsToStubs() bool {
- return proptools.Bool(module.sdkLibraryProperties.Default_to_stubs)
- }
- // Defines how to name the individual component modules the sdk library creates.
- type sdkLibraryComponentNamingScheme interface {
- stubsLibraryModuleName(scope *apiScope, baseName string) string
- stubsSourceModuleName(scope *apiScope, baseName string) string
- apiLibraryModuleName(scope *apiScope, baseName string) string
- sourceStubLibraryModuleName(scope *apiScope, baseName string) string
- }
- type defaultNamingScheme struct {
- }
- func (s *defaultNamingScheme) stubsLibraryModuleName(scope *apiScope, baseName string) string {
- return scope.stubsLibraryModuleName(baseName)
- }
- func (s *defaultNamingScheme) stubsSourceModuleName(scope *apiScope, baseName string) string {
- return scope.stubsSourceModuleName(baseName)
- }
- func (s *defaultNamingScheme) apiLibraryModuleName(scope *apiScope, baseName string) string {
- return scope.apiLibraryModuleName(baseName)
- }
- func (s *defaultNamingScheme) sourceStubLibraryModuleName(scope *apiScope, baseName string) string {
- return scope.sourceStubLibraryModuleName(baseName)
- }
- var _ sdkLibraryComponentNamingScheme = (*defaultNamingScheme)(nil)
- func moduleStubLinkType(name string) (stub bool, ret sdkLinkType) {
- name = strings.TrimSuffix(name, ".from-source")
- // This suffix-based approach is fragile and could potentially mis-trigger.
- // TODO(b/155164730): Clean this up when modules no longer reference sdk_lib stubs directly.
- if strings.HasSuffix(name, apiScopePublic.stubsLibraryModuleNameSuffix()) {
- if name == "hwbinder.stubs" || name == "libcore_private.stubs" {
- // Due to a previous bug, these modules were not considered stubs, so we retain that.
- return false, javaPlatform
- }
- return true, javaSdk
- }
- if strings.HasSuffix(name, apiScopeSystem.stubsLibraryModuleNameSuffix()) {
- return true, javaSystem
- }
- if strings.HasSuffix(name, apiScopeModuleLib.stubsLibraryModuleNameSuffix()) {
- return true, javaModule
- }
- if strings.HasSuffix(name, apiScopeTest.stubsLibraryModuleNameSuffix()) {
- return true, javaSystem
- }
- if strings.HasSuffix(name, apiScopeSystemServer.stubsLibraryModuleNameSuffix()) {
- return true, javaSystemServer
- }
- return false, javaPlatform
- }
- // java_sdk_library is a special Java library that provides optional platform APIs to apps.
- // In practice, it can be viewed as a combination of several modules: 1) stubs library that clients
- // are linked against to, 2) droiddoc module that internally generates API stubs source files,
- // 3) the real runtime shared library that implements the APIs, and 4) XML file for adding
- // the runtime lib to the classpath at runtime if requested via <uses-library>.
- func SdkLibraryFactory() android.Module {
- module := &SdkLibrary{}
- // Initialize information common between source and prebuilt.
- module.initCommon(module)
- module.InitSdkLibraryProperties()
- android.InitApexModule(module)
- InitJavaModule(module, android.HostAndDeviceSupported)
- // Initialize the map from scope to scope specific properties.
- scopeToProperties := make(map[*apiScope]*ApiScopeProperties)
- for _, scope := range allApiScopes {
- scopeToProperties[scope] = scope.scopeSpecificProperties(module)
- }
- module.scopeToProperties = scopeToProperties
- // Add the properties containing visibility rules so that they are checked.
- android.AddVisibilityProperty(module, "impl_library_visibility", &module.sdkLibraryProperties.Impl_library_visibility)
- android.AddVisibilityProperty(module, "stubs_library_visibility", &module.sdkLibraryProperties.Stubs_library_visibility)
- android.AddVisibilityProperty(module, "stubs_source_visibility", &module.sdkLibraryProperties.Stubs_source_visibility)
- module.SetDefaultableHook(func(ctx android.DefaultableHookContext) {
- // If no implementation is required then it cannot be used as a shared library
- // either.
- if !module.requiresRuntimeImplementationLibrary() {
- // If shared_library has been explicitly set to true then it is incompatible
- // with api_only: true.
- if proptools.Bool(module.commonSdkLibraryProperties.Shared_library) {
- ctx.PropertyErrorf("api_only/shared_library", "inconsistent settings, shared_library and api_only cannot both be true")
- }
- // Set shared_library: false.
- module.commonSdkLibraryProperties.Shared_library = proptools.BoolPtr(false)
- }
- if module.initCommonAfterDefaultsApplied(ctx) {
- module.CreateInternalModules(ctx)
- }
- })
- android.InitBazelModule(module)
- return module
- }
- type bazelSdkLibraryAttributes struct {
- Public bazel.StringAttribute
- System bazel.StringAttribute
- Test bazel.StringAttribute
- Module_lib bazel.StringAttribute
- System_server bazel.StringAttribute
- }
- // java_sdk_library bp2build converter
- func (module *SdkLibrary) ConvertWithBp2build(ctx android.TopDownMutatorContext) {
- if ctx.ModuleType() != "java_sdk_library" {
- ctx.MarkBp2buildUnconvertible(bp2build_metrics_proto.UnconvertedReasonType_TYPE_UNSUPPORTED, "")
- return
- }
- nameToAttr := make(map[string]bazel.StringAttribute)
- for _, scope := range module.getGeneratedApiScopes(ctx) {
- apiSurfaceFile := path.Join(module.getApiDir(), scope.apiFilePrefix+"current.txt")
- var scopeStringAttribute bazel.StringAttribute
- scopeStringAttribute.SetValue(apiSurfaceFile)
- nameToAttr[scope.name] = scopeStringAttribute
- }
- attrs := bazelSdkLibraryAttributes{
- Public: nameToAttr["public"],
- System: nameToAttr["system"],
- Test: nameToAttr["test"],
- Module_lib: nameToAttr["module-lib"],
- System_server: nameToAttr["system-server"],
- }
- props := bazel.BazelTargetModuleProperties{
- Rule_class: "java_sdk_library",
- Bzl_load_location: "//build/bazel/rules/java:sdk_library.bzl",
- }
- ctx.CreateBazelTargetModule(props, android.CommonAttributes{Name: module.Name()}, &attrs)
- }
- //
- // SDK library prebuilts
- //
- // Properties associated with each api scope.
- type sdkLibraryScopeProperties struct {
- Jars []string `android:"path"`
- Sdk_version *string
- // List of shared java libs that this module has dependencies to
- Libs []string
- // The stubs source.
- Stub_srcs []string `android:"path"`
- // The current.txt
- Current_api *string `android:"path"`
- // The removed.txt
- Removed_api *string `android:"path"`
- // Annotation zip
- Annotations *string `android:"path"`
- }
- type sdkLibraryImportProperties struct {
- // List of shared java libs, common to all scopes, that this module has
- // dependencies to
- Libs []string
- // If set to true, compile dex files for the stubs. Defaults to false.
- Compile_dex *bool
- // If not empty, classes are restricted to the specified packages and their sub-packages.
- Permitted_packages []string
- }
- type SdkLibraryImport struct {
- android.ModuleBase
- android.DefaultableModuleBase
- prebuilt android.Prebuilt
- android.ApexModuleBase
- hiddenAPI
- dexpreopter
- properties sdkLibraryImportProperties
- // Map from api scope to the scope specific property structure.
- scopeProperties map[*apiScope]*sdkLibraryScopeProperties
- commonToSdkLibraryAndImport
- // The reference to the implementation library created by the source module.
- // Is nil if the source module does not exist.
- implLibraryModule *Library
- // The reference to the xml permissions module created by the source module.
- // Is nil if the source module does not exist.
- xmlPermissionsFileModule *sdkLibraryXml
- // Build path to the dex implementation jar obtained from the prebuilt_apex, if any.
- dexJarFile OptionalDexJarPath
- // Expected install file path of the source module(sdk_library)
- // or dex implementation jar obtained from the prebuilt_apex, if any.
- installFile android.Path
- }
- var _ SdkLibraryDependency = (*SdkLibraryImport)(nil)
- // The type of a structure that contains a field of type sdkLibraryScopeProperties
- // for each apiscope in allApiScopes, e.g. something like:
- //
- // struct {
- // Public sdkLibraryScopeProperties
- // System sdkLibraryScopeProperties
- // ...
- // }
- var allScopeStructType = createAllScopePropertiesStructType()
- // Dynamically create a structure type for each apiscope in allApiScopes.
- func createAllScopePropertiesStructType() reflect.Type {
- var fields []reflect.StructField
- for _, apiScope := range allApiScopes {
- field := reflect.StructField{
- Name: apiScope.fieldName,
- Type: reflect.TypeOf(sdkLibraryScopeProperties{}),
- }
- fields = append(fields, field)
- }
- return reflect.StructOf(fields)
- }
- // Create an instance of the scope specific structure type and return a map
- // from apiscope to a pointer to each scope specific field.
- func createPropertiesInstance() (interface{}, map[*apiScope]*sdkLibraryScopeProperties) {
- allScopePropertiesPtr := reflect.New(allScopeStructType)
- allScopePropertiesStruct := allScopePropertiesPtr.Elem()
- scopeProperties := make(map[*apiScope]*sdkLibraryScopeProperties)
- for _, apiScope := range allApiScopes {
- field := allScopePropertiesStruct.FieldByName(apiScope.fieldName)
- scopeProperties[apiScope] = field.Addr().Interface().(*sdkLibraryScopeProperties)
- }
- return allScopePropertiesPtr.Interface(), scopeProperties
- }
- // java_sdk_library_import imports a prebuilt java_sdk_library.
- func sdkLibraryImportFactory() android.Module {
- module := &SdkLibraryImport{}
- allScopeProperties, scopeToProperties := createPropertiesInstance()
- module.scopeProperties = scopeToProperties
- module.AddProperties(&module.properties, allScopeProperties, &module.importDexpreoptProperties)
- // Initialize information common between source and prebuilt.
- module.initCommon(module)
- android.InitPrebuiltModule(module, &[]string{""})
- android.InitApexModule(module)
- InitJavaModule(module, android.HostAndDeviceSupported)
- module.SetDefaultableHook(func(mctx android.DefaultableHookContext) {
- if module.initCommonAfterDefaultsApplied(mctx) {
- module.createInternalModules(mctx)
- }
- })
- return module
- }
- var _ PermittedPackagesForUpdatableBootJars = (*SdkLibraryImport)(nil)
- func (module *SdkLibraryImport) PermittedPackagesForUpdatableBootJars() []string {
- return module.properties.Permitted_packages
- }
- func (module *SdkLibraryImport) Prebuilt() *android.Prebuilt {
- return &module.prebuilt
- }
- func (module *SdkLibraryImport) Name() string {
- return module.prebuilt.Name(module.ModuleBase.Name())
- }
- func (module *SdkLibraryImport) createInternalModules(mctx android.DefaultableHookContext) {
- // If the build is configured to use prebuilts then force this to be preferred.
- if mctx.Config().AlwaysUsePrebuiltSdks() {
- module.prebuilt.ForcePrefer()
- }
- for apiScope, scopeProperties := range module.scopeProperties {
- if len(scopeProperties.Jars) == 0 {
- continue
- }
- module.createJavaImportForStubs(mctx, apiScope, scopeProperties)
- if len(scopeProperties.Stub_srcs) > 0 {
- module.createPrebuiltStubsSources(mctx, apiScope, scopeProperties)
- }
- }
- javaSdkLibraries := javaSdkLibraries(mctx.Config())
- javaSdkLibrariesLock.Lock()
- defer javaSdkLibrariesLock.Unlock()
- *javaSdkLibraries = append(*javaSdkLibraries, module.BaseModuleName())
- }
- func (module *SdkLibraryImport) createJavaImportForStubs(mctx android.DefaultableHookContext, apiScope *apiScope, scopeProperties *sdkLibraryScopeProperties) {
- // Creates a java import for the jar with ".stubs" suffix
- props := struct {
- Name *string
- Sdk_version *string
- Libs []string
- Jars []string
- Compile_dex *bool
- android.UserSuppliedPrebuiltProperties
- }{}
- props.Name = proptools.StringPtr(module.stubsLibraryModuleName(apiScope))
- props.Sdk_version = scopeProperties.Sdk_version
- // Prepend any of the libs from the legacy public properties to the libs for each of the
- // scopes to avoid having to duplicate them in each scope.
- props.Libs = append(module.properties.Libs, scopeProperties.Libs...)
- props.Jars = scopeProperties.Jars
- // The imports are preferred if the java_sdk_library_import is preferred.
- props.CopyUserSuppliedPropertiesFromPrebuilt(&module.prebuilt)
- // The imports need to be compiled to dex if the java_sdk_library_import requests it.
- compileDex := module.properties.Compile_dex
- if module.stubLibrariesCompiledForDex() {
- compileDex = proptools.BoolPtr(true)
- }
- props.Compile_dex = compileDex
- mctx.CreateModule(ImportFactory, &props, module.sdkComponentPropertiesForChildLibrary())
- }
- func (module *SdkLibraryImport) createPrebuiltStubsSources(mctx android.DefaultableHookContext, apiScope *apiScope, scopeProperties *sdkLibraryScopeProperties) {
- props := struct {
- Name *string
- Srcs []string
- android.UserSuppliedPrebuiltProperties
- }{}
- props.Name = proptools.StringPtr(module.stubsSourceModuleName(apiScope))
- props.Srcs = scopeProperties.Stub_srcs
- // The stubs source is preferred if the java_sdk_library_import is preferred.
- props.CopyUserSuppliedPropertiesFromPrebuilt(&module.prebuilt)
- mctx.CreateModule(PrebuiltStubsSourcesFactory, &props)
- }
- // Add the dependencies on the child module in the component deps mutator so that it
- // creates references to the prebuilt and not the source modules.
- func (module *SdkLibraryImport) ComponentDepsMutator(ctx android.BottomUpMutatorContext) {
- for apiScope, scopeProperties := range module.scopeProperties {
- if len(scopeProperties.Jars) == 0 {
- continue
- }
- // Add dependencies to the prebuilt stubs library
- ctx.AddVariationDependencies(nil, apiScope.stubsTag, android.PrebuiltNameFromSource(module.stubsLibraryModuleName(apiScope)))
- if len(scopeProperties.Stub_srcs) > 0 {
- // Add dependencies to the prebuilt stubs source library
- ctx.AddVariationDependencies(nil, apiScope.stubsSourceTag, android.PrebuiltNameFromSource(module.stubsSourceModuleName(apiScope)))
- }
- }
- }
- // Add other dependencies as normal.
- func (module *SdkLibraryImport) DepsMutator(ctx android.BottomUpMutatorContext) {
- implName := module.implLibraryModuleName()
- if ctx.OtherModuleExists(implName) {
- ctx.AddVariationDependencies(nil, implLibraryTag, implName)
- xmlPermissionsModuleName := module.xmlPermissionsModuleName()
- if module.sharedLibrary() && ctx.OtherModuleExists(xmlPermissionsModuleName) {
- // Add dependency to the rule for generating the xml permissions file
- ctx.AddDependency(module, xmlPermissionsFileTag, xmlPermissionsModuleName)
- }
- }
- }
- func (module *SdkLibraryImport) AndroidMkEntries() []android.AndroidMkEntries {
- // For an SDK library imported from a prebuilt APEX, we don't need a Make module for itself, as we
- // don't need to install it. However, we need to add its dexpreopt outputs as sub-modules, if it
- // is preopted.
- dexpreoptEntries := module.dexpreopter.AndroidMkEntriesForApex()
- return append(dexpreoptEntries, android.AndroidMkEntries{Disabled: true})
- }
- var _ android.ApexModule = (*SdkLibraryImport)(nil)
- // Implements android.ApexModule
- func (module *SdkLibraryImport) DepIsInSameApex(mctx android.BaseModuleContext, dep android.Module) bool {
- depTag := mctx.OtherModuleDependencyTag(dep)
- if depTag == xmlPermissionsFileTag {
- return true
- }
- // None of the other dependencies of the java_sdk_library_import are in the same apex
- // as the one that references this module.
- return false
- }
- // Implements android.ApexModule
- func (module *SdkLibraryImport) ShouldSupportSdkVersion(ctx android.BaseModuleContext,
- sdkVersion android.ApiLevel) error {
- // we don't check prebuilt modules for sdk_version
- return nil
- }
- // Implements android.ApexModule
- func (module *SdkLibraryImport) UniqueApexVariations() bool {
- return module.uniqueApexVariations()
- }
- // MinSdkVersion - Implements hiddenAPIModule
- func (module *SdkLibraryImport) MinSdkVersion(ctx android.EarlyModuleContext) android.ApiLevel {
- return android.NoneApiLevel
- }
- var _ hiddenAPIModule = (*SdkLibraryImport)(nil)
- func (module *SdkLibraryImport) OutputFiles(tag string) (android.Paths, error) {
- paths, err := module.commonOutputFiles(tag)
- if paths != nil || err != nil {
- return paths, err
- }
- if module.implLibraryModule != nil {
- return module.implLibraryModule.OutputFiles(tag)
- } else {
- return nil, nil
- }
- }
- func (module *SdkLibraryImport) GenerateAndroidBuildActions(ctx android.ModuleContext) {
- module.generateCommonBuildActions(ctx)
- // Assume that source module(sdk_library) is installed in /<sdk_library partition>/framework
- module.installFile = android.PathForModuleInstall(ctx, "framework", module.Stem()+".jar")
- // Record the paths to the prebuilt stubs library and stubs source.
- ctx.VisitDirectDeps(func(to android.Module) {
- tag := ctx.OtherModuleDependencyTag(to)
- // Extract information from any of the scope specific dependencies.
- if scopeTag, ok := tag.(scopeDependencyTag); ok {
- apiScope := scopeTag.apiScope
- scopePaths := module.getScopePathsCreateIfNeeded(apiScope)
- // Extract information from the dependency. The exact information extracted
- // is determined by the nature of the dependency which is determined by the tag.
- scopeTag.extractDepInfo(ctx, to, scopePaths)
- } else if tag == implLibraryTag {
- if implLibrary, ok := to.(*Library); ok {
- module.implLibraryModule = implLibrary
- } else {
- ctx.ModuleErrorf("implementation library must be of type *java.Library but was %T", to)
- }
- } else if tag == xmlPermissionsFileTag {
- if xmlPermissionsFileModule, ok := to.(*sdkLibraryXml); ok {
- module.xmlPermissionsFileModule = xmlPermissionsFileModule
- } else {
- ctx.ModuleErrorf("xml permissions file module must be of type *sdkLibraryXml but was %T", to)
- }
- }
- })
- // Populate the scope paths with information from the properties.
- for apiScope, scopeProperties := range module.scopeProperties {
- if len(scopeProperties.Jars) == 0 {
- continue
- }
- paths := module.getScopePathsCreateIfNeeded(apiScope)
- paths.annotationsZip = android.OptionalPathForModuleSrc(ctx, scopeProperties.Annotations)
- paths.currentApiFilePath = android.OptionalPathForModuleSrc(ctx, scopeProperties.Current_api)
- paths.removedApiFilePath = android.OptionalPathForModuleSrc(ctx, scopeProperties.Removed_api)
- }
- if ctx.Device() {
- // If this is a variant created for a prebuilt_apex then use the dex implementation jar
- // obtained from the associated deapexer module.
- ai := ctx.Provider(android.ApexInfoProvider).(android.ApexInfo)
- if ai.ForPrebuiltApex {
- // Get the path of the dex implementation jar from the `deapexer` module.
- di := android.FindDeapexerProviderForModule(ctx)
- if di == nil {
- return // An error has been reported by FindDeapexerProviderForModule.
- }
- dexJarFileApexRootRelative := apexRootRelativePathToJavaLib(module.BaseModuleName())
- if dexOutputPath := di.PrebuiltExportPath(dexJarFileApexRootRelative); dexOutputPath != nil {
- dexJarFile := makeDexJarPathFromPath(dexOutputPath)
- module.dexJarFile = dexJarFile
- installPath := android.PathForModuleInPartitionInstall(
- ctx, "apex", ai.ApexVariationName, dexJarFileApexRootRelative)
- module.installFile = installPath
- module.initHiddenAPI(ctx, dexJarFile, module.findScopePaths(apiScopePublic).stubsImplPath[0], nil)
- module.dexpreopter.installPath = module.dexpreopter.getInstallPath(ctx, installPath)
- module.dexpreopter.isSDKLibrary = true
- module.dexpreopter.uncompressedDex = shouldUncompressDex(ctx, &module.dexpreopter)
- if profilePath := di.PrebuiltExportPath(dexJarFileApexRootRelative + ".prof"); profilePath != nil {
- module.dexpreopter.inputProfilePathOnHost = profilePath
- }
- // Dexpreopting.
- module.dexpreopt(ctx, dexOutputPath)
- } else {
- // This should never happen as a variant for a prebuilt_apex is only created if the
- // prebuilt_apex has been configured to export the java library dex file.
- ctx.ModuleErrorf("internal error: no dex implementation jar available from prebuilt APEX %s", di.ApexModuleName())
- }
- }
- }
- }
- func (module *SdkLibraryImport) sdkJars(ctx android.BaseModuleContext, sdkVersion android.SdkSpec, headerJars bool) android.Paths {
- // For consistency with SdkLibrary make the implementation jar available to libraries that
- // are within the same APEX.
- implLibraryModule := module.implLibraryModule
- if implLibraryModule != nil && withinSameApexesAs(ctx, module) {
- if headerJars {
- return implLibraryModule.HeaderJars()
- } else {
- return implLibraryModule.ImplementationJars()
- }
- }
- return module.selectHeaderJarsForSdkVersion(ctx, sdkVersion)
- }
- // to satisfy SdkLibraryDependency interface
- func (module *SdkLibraryImport) SdkHeaderJars(ctx android.BaseModuleContext, sdkVersion android.SdkSpec) android.Paths {
- // This module is just a wrapper for the prebuilt stubs.
- return module.sdkJars(ctx, sdkVersion, true)
- }
- // to satisfy SdkLibraryDependency interface
- func (module *SdkLibraryImport) SdkImplementationJars(ctx android.BaseModuleContext, sdkVersion android.SdkSpec) android.Paths {
- // This module is just a wrapper for the stubs.
- return module.sdkJars(ctx, sdkVersion, false)
- }
- // to satisfy UsesLibraryDependency interface
- func (module *SdkLibraryImport) DexJarBuildPath() OptionalDexJarPath {
- // The dex implementation jar extracted from the .apex file should be used in preference to the
- // source.
- if module.dexJarFile.IsSet() {
- return module.dexJarFile
- }
- if module.implLibraryModule == nil {
- return makeUnsetDexJarPath()
- } else {
- return module.implLibraryModule.DexJarBuildPath()
- }
- }
- // to satisfy UsesLibraryDependency interface
- func (module *SdkLibraryImport) DexJarInstallPath() android.Path {
- return module.installFile
- }
- // to satisfy UsesLibraryDependency interface
- func (module *SdkLibraryImport) ClassLoaderContexts() dexpreopt.ClassLoaderContextMap {
- return nil
- }
- // to satisfy apex.javaDependency interface
- func (module *SdkLibraryImport) JacocoReportClassesFile() android.Path {
- if module.implLibraryModule == nil {
- return nil
- } else {
- return module.implLibraryModule.JacocoReportClassesFile()
- }
- }
- // to satisfy apex.javaDependency interface
- func (module *SdkLibraryImport) LintDepSets() LintDepSets {
- if module.implLibraryModule == nil {
- return LintDepSets{}
- } else {
- return module.implLibraryModule.LintDepSets()
- }
- }
- func (module *SdkLibraryImport) GetStrictUpdatabilityLinting() bool {
- if module.implLibraryModule == nil {
- return false
- } else {
- return module.implLibraryModule.GetStrictUpdatabilityLinting()
- }
- }
- func (module *SdkLibraryImport) SetStrictUpdatabilityLinting(strictLinting bool) {
- if module.implLibraryModule != nil {
- module.implLibraryModule.SetStrictUpdatabilityLinting(strictLinting)
- }
- }
- // to satisfy apex.javaDependency interface
- func (module *SdkLibraryImport) Stem() string {
- return module.BaseModuleName()
- }
- var _ ApexDependency = (*SdkLibraryImport)(nil)
- // to satisfy java.ApexDependency interface
- func (module *SdkLibraryImport) HeaderJars() android.Paths {
- if module.implLibraryModule == nil {
- return nil
- } else {
- return module.implLibraryModule.HeaderJars()
- }
- }
- // to satisfy java.ApexDependency interface
- func (module *SdkLibraryImport) ImplementationAndResourcesJars() android.Paths {
- if module.implLibraryModule == nil {
- return nil
- } else {
- return module.implLibraryModule.ImplementationAndResourcesJars()
- }
- }
- // to satisfy java.DexpreopterInterface interface
- func (module *SdkLibraryImport) IsInstallable() bool {
- return true
- }
- var _ android.RequiredFilesFromPrebuiltApex = (*SdkLibraryImport)(nil)
- func (module *SdkLibraryImport) RequiredFilesFromPrebuiltApex(ctx android.BaseModuleContext) []string {
- name := module.BaseModuleName()
- return requiredFilesFromPrebuiltApexForImport(name, &module.dexpreopter)
- }
- // java_sdk_library_xml
- type sdkLibraryXml struct {
- android.ModuleBase
- android.DefaultableModuleBase
- android.ApexModuleBase
- properties sdkLibraryXmlProperties
- outputFilePath android.OutputPath
- installDirPath android.InstallPath
- hideApexVariantFromMake bool
- }
- type sdkLibraryXmlProperties struct {
- // canonical name of the lib
- Lib_name *string
- // Signals that this shared library is part of the bootclasspath starting
- // on the version indicated in this attribute.
- //
- // This will make platforms at this level and above to ignore
- // <uses-library> tags with this library name because the library is already
- // available
- On_bootclasspath_since *string
- // Signals that this shared library was part of the bootclasspath before
- // (but not including) the version indicated in this attribute.
- //
- // The system will automatically add a <uses-library> tag with this library to
- // apps that target any SDK less than the version indicated in this attribute.
- On_bootclasspath_before *string
- // Indicates that PackageManager should ignore this shared library if the
- // platform is below the version indicated in this attribute.
- //
- // This means that the device won't recognise this library as installed.
- Min_device_sdk *string
- // Indicates that PackageManager should ignore this shared library if the
- // platform is above the version indicated in this attribute.
- //
- // This means that the device won't recognise this library as installed.
- Max_device_sdk *string
- // The SdkLibrary's min api level as a string
- //
- // This value comes from the ApiLevel of the MinSdkVersion property.
- Sdk_library_min_api_level *string
- }
- // java_sdk_library_xml builds the permission xml file for a java_sdk_library.
- // Not to be used directly by users. java_sdk_library internally uses this.
- func sdkLibraryXmlFactory() android.Module {
- module := &sdkLibraryXml{}
- module.AddProperties(&module.properties)
- android.InitApexModule(module)
- android.InitAndroidArchModule(module, android.DeviceSupported, android.MultilibCommon)
- return module
- }
- func (module *sdkLibraryXml) UniqueApexVariations() bool {
- // sdkLibraryXml needs a unique variation per APEX because the generated XML file contains the path to the
- // mounted APEX, which contains the name of the APEX.
- return true
- }
- // from android.PrebuiltEtcModule
- func (module *sdkLibraryXml) BaseDir() string {
- return "etc"
- }
- // from android.PrebuiltEtcModule
- func (module *sdkLibraryXml) SubDir() string {
- return "permissions"
- }
- // from android.PrebuiltEtcModule
- func (module *sdkLibraryXml) OutputFile() android.OutputPath {
- return module.outputFilePath
- }
- // from android.ApexModule
- func (module *sdkLibraryXml) AvailableFor(what string) bool {
- return true
- }
- func (module *sdkLibraryXml) DepsMutator(ctx android.BottomUpMutatorContext) {
- // do nothing
- }
- var _ android.ApexModule = (*sdkLibraryXml)(nil)
- // Implements android.ApexModule
- func (module *sdkLibraryXml) ShouldSupportSdkVersion(ctx android.BaseModuleContext,
- sdkVersion android.ApiLevel) error {
- // sdkLibraryXml doesn't need to be checked separately because java_sdk_library is checked
- return nil
- }
- // File path to the runtime implementation library
- func (module *sdkLibraryXml) implPath(ctx android.ModuleContext) string {
- implName := proptools.String(module.properties.Lib_name)
- if apexInfo := ctx.Provider(android.ApexInfoProvider).(android.ApexInfo); !apexInfo.IsForPlatform() {
- // TODO(b/146468504): ApexVariationName() is only a soong module name, not apex name.
- // In most cases, this works fine. But when apex_name is set or override_apex is used
- // this can be wrong.
- return fmt.Sprintf("/apex/%s/javalib/%s.jar", apexInfo.ApexVariationName, implName)
- }
- partition := "system"
- if module.SocSpecific() {
- partition = "vendor"
- } else if module.DeviceSpecific() {
- partition = "odm"
- } else if module.ProductSpecific() {
- partition = "product"
- } else if module.SystemExtSpecific() {
- partition = "system_ext"
- }
- return "/" + partition + "/framework/" + implName + ".jar"
- }
- func formattedOptionalSdkLevelAttribute(ctx android.ModuleContext, attrName string, value *string) string {
- if value == nil {
- return ""
- }
- apiLevel, err := android.ApiLevelFromUser(ctx, *value)
- if err != nil {
- // attributes in bp files have underscores but in the xml have dashes.
- ctx.PropertyErrorf(strings.ReplaceAll(attrName, "-", "_"), err.Error())
- return ""
- }
- if apiLevel.IsCurrent() {
- // passing "current" would always mean a future release, never the current (or the current in
- // progress) which means some conditions would never be triggered.
- ctx.PropertyErrorf(strings.ReplaceAll(attrName, "-", "_"),
- `"current" is not an allowed value for this attribute`)
- return ""
- }
- // "safeValue" is safe because it translates finalized codenames to a string
- // with their SDK int.
- safeValue := apiLevel.String()
- return formattedOptionalAttribute(attrName, &safeValue)
- }
- // formats an attribute for the xml permissions file if the value is not null
- // returns empty string otherwise
- func formattedOptionalAttribute(attrName string, value *string) string {
- if value == nil {
- return ""
- }
- return fmt.Sprintf(` %s=\"%s\"\n`, attrName, *value)
- }
- func (module *sdkLibraryXml) permissionsContents(ctx android.ModuleContext) string {
- libName := proptools.String(module.properties.Lib_name)
- libNameAttr := formattedOptionalAttribute("name", &libName)
- filePath := module.implPath(ctx)
- filePathAttr := formattedOptionalAttribute("file", &filePath)
- implicitFromAttr := formattedOptionalSdkLevelAttribute(ctx, "on-bootclasspath-since", module.properties.On_bootclasspath_since)
- implicitUntilAttr := formattedOptionalSdkLevelAttribute(ctx, "on-bootclasspath-before", module.properties.On_bootclasspath_before)
- minSdkAttr := formattedOptionalSdkLevelAttribute(ctx, "min-device-sdk", module.properties.Min_device_sdk)
- maxSdkAttr := formattedOptionalSdkLevelAttribute(ctx, "max-device-sdk", module.properties.Max_device_sdk)
- // <library> is understood in all android versions whereas <apex-library> is only understood from API T (and ignored before that).
- // similarly, min_device_sdk is only understood from T. So if a library is using that, we need to use the apex-library to make sure this library is not loaded before T
- var libraryTag string
- if module.properties.Min_device_sdk != nil {
- libraryTag = ` <apex-library\n`
- } else {
- libraryTag = ` <library\n`
- }
- return strings.Join([]string{
- `<?xml version=\"1.0\" encoding=\"utf-8\"?>\n`,
- `<!-- Copyright (C) 2018 The Android Open Source Project\n`,
- `\n`,
- ` Licensed under the Apache License, Version 2.0 (the \"License\");\n`,
- ` you may not use this file except in compliance with the License.\n`,
- ` You may obtain a copy of the License at\n`,
- `\n`,
- ` http://www.apache.org/licenses/LICENSE-2.0\n`,
- `\n`,
- ` Unless required by applicable law or agreed to in writing, software\n`,
- ` distributed under the License is distributed on an \"AS IS\" BASIS,\n`,
- ` WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n`,
- ` See the License for the specific language governing permissions and\n`,
- ` limitations under the License.\n`,
- `-->\n`,
- `<permissions>\n`,
- libraryTag,
- libNameAttr,
- filePathAttr,
- implicitFromAttr,
- implicitUntilAttr,
- minSdkAttr,
- maxSdkAttr,
- ` />\n`,
- `</permissions>\n`}, "")
- }
- func (module *sdkLibraryXml) GenerateAndroidBuildActions(ctx android.ModuleContext) {
- module.hideApexVariantFromMake = !ctx.Provider(android.ApexInfoProvider).(android.ApexInfo).IsForPlatform()
- libName := proptools.String(module.properties.Lib_name)
- module.selfValidate(ctx)
- xmlContent := module.permissionsContents(ctx)
- module.outputFilePath = android.PathForModuleOut(ctx, libName+".xml").OutputPath
- rule := android.NewRuleBuilder(pctx, ctx)
- rule.Command().
- Text("/bin/bash -c \"echo -e '" + xmlContent + "'\" > ").
- Output(module.outputFilePath)
- rule.Build("java_sdk_xml", "Permission XML")
- module.installDirPath = android.PathForModuleInstall(ctx, "etc", module.SubDir())
- }
- func (module *sdkLibraryXml) AndroidMkEntries() []android.AndroidMkEntries {
- if module.hideApexVariantFromMake {
- return []android.AndroidMkEntries{{
- Disabled: true,
- }}
- }
- return []android.AndroidMkEntries{{
- Class: "ETC",
- OutputFile: android.OptionalPathForPath(module.outputFilePath),
- ExtraEntries: []android.AndroidMkExtraEntriesFunc{
- func(ctx android.AndroidMkExtraEntriesContext, entries *android.AndroidMkEntries) {
- entries.SetString("LOCAL_MODULE_TAGS", "optional")
- entries.SetString("LOCAL_MODULE_PATH", module.installDirPath.String())
- entries.SetString("LOCAL_INSTALLED_MODULE_STEM", module.outputFilePath.Base())
- },
- },
- }}
- }
- func (module *sdkLibraryXml) selfValidate(ctx android.ModuleContext) {
- module.validateAtLeastTAttributes(ctx)
- module.validateMinAndMaxDeviceSdk(ctx)
- module.validateMinMaxDeviceSdkAndModuleMinSdk(ctx)
- module.validateOnBootclasspathBeforeRequirements(ctx)
- }
- func (module *sdkLibraryXml) validateAtLeastTAttributes(ctx android.ModuleContext) {
- t := android.ApiLevelOrPanic(ctx, "Tiramisu")
- module.attrAtLeastT(ctx, t, module.properties.Min_device_sdk, "min_device_sdk")
- module.attrAtLeastT(ctx, t, module.properties.Max_device_sdk, "max_device_sdk")
- module.attrAtLeastT(ctx, t, module.properties.On_bootclasspath_before, "on_bootclasspath_before")
- module.attrAtLeastT(ctx, t, module.properties.On_bootclasspath_since, "on_bootclasspath_since")
- }
- func (module *sdkLibraryXml) attrAtLeastT(ctx android.ModuleContext, t android.ApiLevel, attr *string, attrName string) {
- if attr != nil {
- if level, err := android.ApiLevelFromUser(ctx, *attr); err == nil {
- // we will inform the user of invalid inputs when we try to write the
- // permissions xml file so we don't need to do it here
- if t.GreaterThan(level) {
- ctx.PropertyErrorf(attrName, "Attribute value needs to be at least T")
- }
- }
- }
- }
- func (module *sdkLibraryXml) validateMinAndMaxDeviceSdk(ctx android.ModuleContext) {
- if module.properties.Min_device_sdk != nil && module.properties.Max_device_sdk != nil {
- min, minErr := android.ApiLevelFromUser(ctx, *module.properties.Min_device_sdk)
- max, maxErr := android.ApiLevelFromUser(ctx, *module.properties.Max_device_sdk)
- if minErr == nil && maxErr == nil {
- // we will inform the user of invalid inputs when we try to write the
- // permissions xml file so we don't need to do it here
- if min.GreaterThan(max) {
- ctx.ModuleErrorf("min_device_sdk can't be greater than max_device_sdk")
- }
- }
- }
- }
- func (module *sdkLibraryXml) validateMinMaxDeviceSdkAndModuleMinSdk(ctx android.ModuleContext) {
- moduleMinApi := android.ApiLevelOrPanic(ctx, *module.properties.Sdk_library_min_api_level)
- if module.properties.Min_device_sdk != nil {
- api, err := android.ApiLevelFromUser(ctx, *module.properties.Min_device_sdk)
- if err == nil {
- if moduleMinApi.GreaterThan(api) {
- ctx.PropertyErrorf("min_device_sdk", "Can't be less than module's min sdk (%s)", moduleMinApi)
- }
- }
- }
- if module.properties.Max_device_sdk != nil {
- api, err := android.ApiLevelFromUser(ctx, *module.properties.Max_device_sdk)
- if err == nil {
- if moduleMinApi.GreaterThan(api) {
- ctx.PropertyErrorf("max_device_sdk", "Can't be less than module's min sdk (%s)", moduleMinApi)
- }
- }
- }
- }
- func (module *sdkLibraryXml) validateOnBootclasspathBeforeRequirements(ctx android.ModuleContext) {
- moduleMinApi := android.ApiLevelOrPanic(ctx, *module.properties.Sdk_library_min_api_level)
- if module.properties.On_bootclasspath_before != nil {
- t := android.ApiLevelOrPanic(ctx, "Tiramisu")
- // if we use the attribute, then we need to do this validation
- if moduleMinApi.LessThan(t) {
- // if minAPi is < T, then we need to have min_device_sdk (which only accepts T+)
- if module.properties.Min_device_sdk == nil {
- ctx.PropertyErrorf("on_bootclasspath_before", "Using this property requires that the module's min_sdk_version or the shared library's min_device_sdk is at least T")
- }
- }
- }
- }
- type sdkLibrarySdkMemberType struct {
- android.SdkMemberTypeBase
- }
- func (s *sdkLibrarySdkMemberType) AddDependencies(ctx android.SdkDependencyContext, dependencyTag blueprint.DependencyTag, names []string) {
- ctx.AddVariationDependencies(nil, dependencyTag, names...)
- }
- func (s *sdkLibrarySdkMemberType) IsInstance(module android.Module) bool {
- _, ok := module.(*SdkLibrary)
- return ok
- }
- func (s *sdkLibrarySdkMemberType) AddPrebuiltModule(ctx android.SdkMemberContext, member android.SdkMember) android.BpModule {
- return ctx.SnapshotBuilder().AddPrebuiltModule(member, "java_sdk_library_import")
- }
- func (s *sdkLibrarySdkMemberType) CreateVariantPropertiesStruct() android.SdkMemberProperties {
- return &sdkLibrarySdkMemberProperties{}
- }
- var javaSdkLibrarySdkMemberType = &sdkLibrarySdkMemberType{
- android.SdkMemberTypeBase{
- PropertyName: "java_sdk_libs",
- SupportsSdk: true,
- },
- }
- type sdkLibrarySdkMemberProperties struct {
- android.SdkMemberPropertiesBase
- // Stem name for files in the sdk snapshot.
- //
- // This is used to construct the path names of various sdk library files in the sdk snapshot to
- // make sure that they match the finalized versions of those files in prebuilts/sdk.
- //
- // This property is marked as keep so that it will be kept in all instances of this struct, will
- // not be cleared but will be copied to common structs. That is needed because this field is used
- // to construct many file names for other parts of this struct and so it needs to be present in
- // all structs. If it was not marked as keep then it would be cleared in some structs and so would
- // be unavailable for generating file names if there were other properties that were still set.
- Stem string `sdk:"keep"`
- // Scope to per scope properties.
- Scopes map[*apiScope]*scopeProperties
- // The Java stubs source files.
- Stub_srcs []string
- // The naming scheme.
- Naming_scheme *string
- // True if the java_sdk_library_import is for a shared library, false
- // otherwise.
- Shared_library *bool
- // True if the stub imports should produce dex jars.
- Compile_dex *bool
- // The paths to the doctag files to add to the prebuilt.
- Doctag_paths android.Paths
- Permitted_packages []string
- // Signals that this shared library is part of the bootclasspath starting
- // on the version indicated in this attribute.
- //
- // This will make platforms at this level and above to ignore
- // <uses-library> tags with this library name because the library is already
- // available
- On_bootclasspath_since *string
- // Signals that this shared library was part of the bootclasspath before
- // (but not including) the version indicated in this attribute.
- //
- // The system will automatically add a <uses-library> tag with this library to
- // apps that target any SDK less than the version indicated in this attribute.
- On_bootclasspath_before *string
- // Indicates that PackageManager should ignore this shared library if the
- // platform is below the version indicated in this attribute.
- //
- // This means that the device won't recognise this library as installed.
- Min_device_sdk *string
- // Indicates that PackageManager should ignore this shared library if the
- // platform is above the version indicated in this attribute.
- //
- // This means that the device won't recognise this library as installed.
- Max_device_sdk *string
- DexPreoptProfileGuided *bool `supported_build_releases:"UpsideDownCake+"`
- }
- type scopeProperties struct {
- Jars android.Paths
- StubsSrcJar android.Path
- CurrentApiFile android.Path
- RemovedApiFile android.Path
- AnnotationsZip android.Path `supported_build_releases:"Tiramisu+"`
- SdkVersion string
- }
- func (s *sdkLibrarySdkMemberProperties) PopulateFromVariant(ctx android.SdkMemberContext, variant android.Module) {
- sdk := variant.(*SdkLibrary)
- // Copy the stem name for files in the sdk snapshot.
- s.Stem = sdk.distStem()
- s.Scopes = make(map[*apiScope]*scopeProperties)
- for _, apiScope := range allApiScopes {
- paths := sdk.findScopePaths(apiScope)
- if paths == nil {
- continue
- }
- jars := paths.stubsImplPath
- if len(jars) > 0 {
- properties := scopeProperties{}
- properties.Jars = jars
- properties.SdkVersion = sdk.sdkVersionForStubsLibrary(ctx.SdkModuleContext(), apiScope)
- properties.StubsSrcJar = paths.stubsSrcJar.Path()
- if paths.currentApiFilePath.Valid() {
- properties.CurrentApiFile = paths.currentApiFilePath.Path()
- }
- if paths.removedApiFilePath.Valid() {
- properties.RemovedApiFile = paths.removedApiFilePath.Path()
- }
- // The annotations zip is only available for modules that set annotations_enabled: true.
- if paths.annotationsZip.Valid() {
- properties.AnnotationsZip = paths.annotationsZip.Path()
- }
- s.Scopes[apiScope] = &properties
- }
- }
- s.Naming_scheme = sdk.commonSdkLibraryProperties.Naming_scheme
- s.Shared_library = proptools.BoolPtr(sdk.sharedLibrary())
- s.Compile_dex = sdk.dexProperties.Compile_dex
- s.Doctag_paths = sdk.doctagPaths
- s.Permitted_packages = sdk.PermittedPackagesForUpdatableBootJars()
- s.On_bootclasspath_since = sdk.commonSdkLibraryProperties.On_bootclasspath_since
- s.On_bootclasspath_before = sdk.commonSdkLibraryProperties.On_bootclasspath_before
- s.Min_device_sdk = sdk.commonSdkLibraryProperties.Min_device_sdk
- s.Max_device_sdk = sdk.commonSdkLibraryProperties.Max_device_sdk
- if sdk.dexpreopter.dexpreoptProperties.Dex_preopt_result.Profile_guided {
- s.DexPreoptProfileGuided = proptools.BoolPtr(true)
- }
- }
- func (s *sdkLibrarySdkMemberProperties) AddToPropertySet(ctx android.SdkMemberContext, propertySet android.BpPropertySet) {
- if s.Naming_scheme != nil {
- propertySet.AddProperty("naming_scheme", proptools.String(s.Naming_scheme))
- }
- if s.Shared_library != nil {
- propertySet.AddProperty("shared_library", *s.Shared_library)
- }
- if s.Compile_dex != nil {
- propertySet.AddProperty("compile_dex", *s.Compile_dex)
- }
- if len(s.Permitted_packages) > 0 {
- propertySet.AddProperty("permitted_packages", s.Permitted_packages)
- }
- dexPreoptSet := propertySet.AddPropertySet("dex_preopt")
- if s.DexPreoptProfileGuided != nil {
- dexPreoptSet.AddProperty("profile_guided", proptools.Bool(s.DexPreoptProfileGuided))
- }
- stem := s.Stem
- for _, apiScope := range allApiScopes {
- if properties, ok := s.Scopes[apiScope]; ok {
- scopeSet := propertySet.AddPropertySet(apiScope.propertyName)
- scopeDir := apiScope.snapshotRelativeDir()
- var jars []string
- for _, p := range properties.Jars {
- dest := filepath.Join(scopeDir, stem+"-stubs.jar")
- ctx.SnapshotBuilder().CopyToSnapshot(p, dest)
- jars = append(jars, dest)
- }
- scopeSet.AddProperty("jars", jars)
- if ctx.SdkModuleContext().Config().IsEnvTrue("SOONG_SDK_SNAPSHOT_USE_SRCJAR") {
- // Copy the stubs source jar into the snapshot zip as is.
- srcJarSnapshotPath := filepath.Join(scopeDir, stem+".srcjar")
- ctx.SnapshotBuilder().CopyToSnapshot(properties.StubsSrcJar, srcJarSnapshotPath)
- scopeSet.AddProperty("stub_srcs", []string{srcJarSnapshotPath})
- } else {
- // Merge the stubs source jar into the snapshot zip so that when it is unpacked
- // the source files are also unpacked.
- snapshotRelativeDir := filepath.Join(scopeDir, stem+"_stub_sources")
- ctx.SnapshotBuilder().UnzipToSnapshot(properties.StubsSrcJar, snapshotRelativeDir)
- scopeSet.AddProperty("stub_srcs", []string{snapshotRelativeDir})
- }
- if properties.CurrentApiFile != nil {
- currentApiSnapshotPath := apiScope.snapshotRelativeCurrentApiTxtPath(stem)
- ctx.SnapshotBuilder().CopyToSnapshot(properties.CurrentApiFile, currentApiSnapshotPath)
- scopeSet.AddProperty("current_api", currentApiSnapshotPath)
- }
- if properties.RemovedApiFile != nil {
- removedApiSnapshotPath := apiScope.snapshotRelativeRemovedApiTxtPath(stem)
- ctx.SnapshotBuilder().CopyToSnapshot(properties.RemovedApiFile, removedApiSnapshotPath)
- scopeSet.AddProperty("removed_api", removedApiSnapshotPath)
- }
- if properties.AnnotationsZip != nil {
- annotationsSnapshotPath := filepath.Join(scopeDir, stem+"_annotations.zip")
- ctx.SnapshotBuilder().CopyToSnapshot(properties.AnnotationsZip, annotationsSnapshotPath)
- scopeSet.AddProperty("annotations", annotationsSnapshotPath)
- }
- if properties.SdkVersion != "" {
- scopeSet.AddProperty("sdk_version", properties.SdkVersion)
- }
- }
- }
- if len(s.Doctag_paths) > 0 {
- dests := []string{}
- for _, p := range s.Doctag_paths {
- dest := filepath.Join("doctags", p.Rel())
- ctx.SnapshotBuilder().CopyToSnapshot(p, dest)
- dests = append(dests, dest)
- }
- propertySet.AddProperty("doctag_files", dests)
- }
- }
|