1// Copyright 2020 Google Inc. All rights reserved. 2// 3// Licensed under the Apache License, Version 2.0 (the "License"); 4// you may not use this file except in compliance with the License. 5// You may obtain a copy of the License at 6// 7// http://www.apache.org/licenses/LICENSE-2.0 8// 9// Unless required by applicable law or agreed to in writing, software 10// distributed under the License is distributed on an "AS IS" BASIS, 11// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 12// See the License for the specific language governing permissions and 13// limitations under the License. 14 15package cc 16 17import ( 18 "android/soong/android" 19 "android/soong/genrule" 20) 21 22// sdkMutator sets a creates a platform and an SDK variant for modules 23// that set sdk_version, and ignores sdk_version for the platform 24// variant. The SDK variant will be used for embedding in APKs 25// that may be installed on older platforms. Apexes use their own 26// variants that enforce backwards compatibility. 27func sdkMutator(ctx android.BottomUpMutatorContext) { 28 if ctx.Os() != android.Android { 29 return 30 } 31 32 switch m := ctx.Module().(type) { 33 case LinkableInterface: 34 if m.AlwaysSdk() { 35 if !m.UseSdk() && !m.SplitPerApiLevel() { 36 ctx.ModuleErrorf("UseSdk() must return true when AlwaysSdk is set, did the factory forget to set Sdk_version?") 37 } 38 ctx.CreateVariations("sdk") 39 } else if m.UseSdk() || m.SplitPerApiLevel() { 40 modules := ctx.CreateVariations("", "sdk") 41 42 // Clear the sdk_version property for the platform (non-SDK) variant so later code 43 // doesn't get confused by it. 44 modules[0].(*Module).Properties.Sdk_version = nil 45 46 // Mark the SDK variant. 47 modules[1].(*Module).Properties.IsSdkVariant = true 48 49 if ctx.Config().UnbundledBuildApps() { 50 // For an unbundled apps build, hide the platform variant from Make. 51 modules[0].(*Module).Properties.HideFromMake = true 52 modules[0].(*Module).Properties.PreventInstall = true 53 } else { 54 // For a platform build, mark the SDK variant so that it gets a ".sdk" suffix when 55 // exposed to Make. 56 modules[1].(*Module).Properties.SdkAndPlatformVariantVisibleToMake = true 57 modules[1].(*Module).Properties.PreventInstall = true 58 } 59 ctx.AliasVariation("") 60 } else { 61 if m, ok := ctx.Module().(*Module); ok { 62 // Clear the sdk_version property for modules that don't have an SDK variant so 63 // later code doesn't get confused by it. 64 m.Properties.Sdk_version = nil 65 } 66 ctx.CreateVariations("") 67 ctx.AliasVariation("") 68 } 69 case *genrule.Module: 70 if p, ok := m.Extra.(*GenruleExtraProperties); ok { 71 if String(p.Sdk_version) != "" { 72 ctx.CreateVariations("", "sdk") 73 } else { 74 ctx.CreateVariations("") 75 } 76 ctx.AliasVariation("") 77 } 78 case *snapshot: 79 ctx.CreateVariations("") 80 } 81} 82