diff options
Diffstat (limited to 'dexpreopt/class_loader_context_test.go')
-rw-r--r-- | dexpreopt/class_loader_context_test.go | 287 |
1 files changed, 287 insertions, 0 deletions
diff --git a/dexpreopt/class_loader_context_test.go b/dexpreopt/class_loader_context_test.go new file mode 100644 index 000000000..610a4c9ec --- /dev/null +++ b/dexpreopt/class_loader_context_test.go @@ -0,0 +1,287 @@ +// Copyright 2020 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 dexpreopt + +// This file contains unit tests for class loader context structure. +// For class loader context tests involving .bp files, see TestUsesLibraries in java package. + +import ( + "fmt" + "reflect" + "strings" + "testing" + + "android/soong/android" +) + +func TestCLC(t *testing.T) { + // Construct class loader context with the following structure: + // . + // ├── 29 + // │ ├── android.hidl.manager + // │ └── android.hidl.base + // │ + // └── any + // ├── a + // ├── b + // ├── c + // ├── d + // │ ├── a2 + // │ ├── b2 + // │ └── c2 + // │ ├── a1 + // │ └── b1 + // ├── f + // ├── a3 + // └── b3 + // + ctx := testContext() + + m := make(ClassLoaderContextMap) + + m.AddContext(ctx, AnySdkVersion, "a", buildPath(ctx, "a"), installPath(ctx, "a"), nil) + m.AddContext(ctx, AnySdkVersion, "b", buildPath(ctx, "b"), installPath(ctx, "b"), nil) + m.AddContext(ctx, AnySdkVersion, "c", buildPath(ctx, "c"), installPath(ctx, "c"), nil) + + // Add some libraries with nested subcontexts. + + m1 := make(ClassLoaderContextMap) + m1.AddContext(ctx, AnySdkVersion, "a1", buildPath(ctx, "a1"), installPath(ctx, "a1"), nil) + m1.AddContext(ctx, AnySdkVersion, "b1", buildPath(ctx, "b1"), installPath(ctx, "b1"), nil) + + m2 := make(ClassLoaderContextMap) + m2.AddContext(ctx, AnySdkVersion, "a2", buildPath(ctx, "a2"), installPath(ctx, "a2"), nil) + m2.AddContext(ctx, AnySdkVersion, "b2", buildPath(ctx, "b2"), installPath(ctx, "b2"), nil) + m2.AddContext(ctx, AnySdkVersion, "c2", buildPath(ctx, "c2"), installPath(ctx, "c2"), m1) + + m3 := make(ClassLoaderContextMap) + m3.AddContext(ctx, AnySdkVersion, "a3", buildPath(ctx, "a3"), installPath(ctx, "a3"), nil) + m3.AddContext(ctx, AnySdkVersion, "b3", buildPath(ctx, "b3"), installPath(ctx, "b3"), nil) + + m.AddContext(ctx, AnySdkVersion, "d", buildPath(ctx, "d"), installPath(ctx, "d"), m2) + // When the same library is both in conditional and unconditional context, it should be removed + // from conditional context. + m.AddContext(ctx, 42, "f", buildPath(ctx, "f"), installPath(ctx, "f"), nil) + m.AddContext(ctx, AnySdkVersion, "f", buildPath(ctx, "f"), installPath(ctx, "f"), nil) + + // Merge map with implicit root library that is among toplevel contexts => does nothing. + m.AddContextMap(m1, "c") + // Merge map with implicit root library that is not among toplevel contexts => all subcontexts + // of the other map are added as toplevel contexts. + m.AddContextMap(m3, "m_g") + + // Compatibility libraries with unknown install paths get default paths. + m.AddContext(ctx, 29, AndroidHidlManager, buildPath(ctx, AndroidHidlManager), nil, nil) + m.AddContext(ctx, 29, AndroidHidlBase, buildPath(ctx, AndroidHidlBase), nil, nil) + + // Add "android.test.mock" to conditional CLC, observe that is gets removed because it is only + // needed as a compatibility library if "android.test.runner" is in CLC as well. + m.AddContext(ctx, 30, AndroidTestMock, buildPath(ctx, AndroidTestMock), nil, nil) + + valid, validationError := validateClassLoaderContext(m) + + fixClassLoaderContext(m) + + var haveStr string + var havePaths android.Paths + var haveUsesLibs []string + if valid && validationError == nil { + haveStr, havePaths = ComputeClassLoaderContext(m) + haveUsesLibs = m.UsesLibs() + } + + // Test that validation is successful (all paths are known). + t.Run("validate", func(t *testing.T) { + if !(valid && validationError == nil) { + t.Errorf("invalid class loader context") + } + }) + + // Test that class loader context structure is correct. + t.Run("string", func(t *testing.T) { + wantStr := " --host-context-for-sdk 29 " + + "PCL[out/" + AndroidHidlManager + ".jar]#" + + "PCL[out/" + AndroidHidlBase + ".jar]" + + " --target-context-for-sdk 29 " + + "PCL[/system/framework/" + AndroidHidlManager + ".jar]#" + + "PCL[/system/framework/" + AndroidHidlBase + ".jar]" + + " --host-context-for-sdk any " + + "PCL[out/a.jar]#PCL[out/b.jar]#PCL[out/c.jar]#PCL[out/d.jar]" + + "{PCL[out/a2.jar]#PCL[out/b2.jar]#PCL[out/c2.jar]" + + "{PCL[out/a1.jar]#PCL[out/b1.jar]}}#" + + "PCL[out/f.jar]#PCL[out/a3.jar]#PCL[out/b3.jar]" + + " --target-context-for-sdk any " + + "PCL[/system/a.jar]#PCL[/system/b.jar]#PCL[/system/c.jar]#PCL[/system/d.jar]" + + "{PCL[/system/a2.jar]#PCL[/system/b2.jar]#PCL[/system/c2.jar]" + + "{PCL[/system/a1.jar]#PCL[/system/b1.jar]}}#" + + "PCL[/system/f.jar]#PCL[/system/a3.jar]#PCL[/system/b3.jar]" + if wantStr != haveStr { + t.Errorf("\nwant class loader context: %s\nhave class loader context: %s", wantStr, haveStr) + } + }) + + // Test that all expected build paths are gathered. + t.Run("paths", func(t *testing.T) { + wantPaths := []string{ + "out/android.hidl.manager-V1.0-java.jar", "out/android.hidl.base-V1.0-java.jar", + "out/a.jar", "out/b.jar", "out/c.jar", "out/d.jar", + "out/a2.jar", "out/b2.jar", "out/c2.jar", + "out/a1.jar", "out/b1.jar", + "out/f.jar", "out/a3.jar", "out/b3.jar", + } + if !reflect.DeepEqual(wantPaths, havePaths.Strings()) { + t.Errorf("\nwant paths: %s\nhave paths: %s", wantPaths, havePaths) + } + }) + + // Test for libraries that are added by the manifest_fixer. + t.Run("uses libs", func(t *testing.T) { + wantUsesLibs := []string{"a", "b", "c", "d", "f", "a3", "b3"} + if !reflect.DeepEqual(wantUsesLibs, haveUsesLibs) { + t.Errorf("\nwant uses libs: %s\nhave uses libs: %s", wantUsesLibs, haveUsesLibs) + } + }) +} + +func TestCLCJson(t *testing.T) { + ctx := testContext() + m := make(ClassLoaderContextMap) + m.AddContext(ctx, 28, "a", buildPath(ctx, "a"), installPath(ctx, "a"), nil) + m.AddContext(ctx, 29, "b", buildPath(ctx, "b"), installPath(ctx, "b"), nil) + m.AddContext(ctx, 30, "c", buildPath(ctx, "c"), installPath(ctx, "c"), nil) + m.AddContext(ctx, AnySdkVersion, "d", buildPath(ctx, "d"), installPath(ctx, "d"), nil) + jsonCLC := toJsonClassLoaderContext(m) + restored := fromJsonClassLoaderContext(ctx, jsonCLC) + android.AssertIntEquals(t, "The size of the maps should be the same.", len(m), len(restored)) + for k := range m { + a, _ := m[k] + b, ok := restored[k] + android.AssertBoolEquals(t, "The both maps should have the same keys.", ok, true) + android.AssertIntEquals(t, "The size of the elements should be the same.", len(a), len(b)) + for i, elemA := range a { + before := fmt.Sprintf("%v", *elemA) + after := fmt.Sprintf("%v", *b[i]) + android.AssertStringEquals(t, "The content should be the same.", before, after) + } + } +} + +// Test that unknown library paths cause a validation error. +func testCLCUnknownPath(t *testing.T, whichPath string) { + ctx := testContext() + + m := make(ClassLoaderContextMap) + if whichPath == "build" { + m.AddContext(ctx, AnySdkVersion, "a", nil, nil, nil) + } else { + m.AddContext(ctx, AnySdkVersion, "a", buildPath(ctx, "a"), nil, nil) + } + + // The library should be added to <uses-library> tags by the manifest_fixer. + t.Run("uses libs", func(t *testing.T) { + haveUsesLibs := m.UsesLibs() + wantUsesLibs := []string{"a"} + if !reflect.DeepEqual(wantUsesLibs, haveUsesLibs) { + t.Errorf("\nwant uses libs: %s\nhave uses libs: %s", wantUsesLibs, haveUsesLibs) + } + }) + + // But CLC cannot be constructed: there is a validation error. + _, err := validateClassLoaderContext(m) + checkError(t, err, fmt.Sprintf("invalid %s path for <uses-library> \"a\"", whichPath)) +} + +// Test that unknown build path is an error. +func TestCLCUnknownBuildPath(t *testing.T) { + testCLCUnknownPath(t, "build") +} + +// Test that unknown install path is an error. +func TestCLCUnknownInstallPath(t *testing.T) { + testCLCUnknownPath(t, "install") +} + +// An attempt to add conditional nested subcontext should fail. +func TestCLCNestedConditional(t *testing.T) { + ctx := testContext() + m1 := make(ClassLoaderContextMap) + m1.AddContext(ctx, 42, "a", buildPath(ctx, "a"), installPath(ctx, "a"), nil) + m := make(ClassLoaderContextMap) + err := m.addContext(ctx, AnySdkVersion, "b", buildPath(ctx, "b"), installPath(ctx, "b"), m1) + checkError(t, err, "nested class loader context shouldn't have conditional part") +} + +// Test for SDK version order in conditional CLC: no matter in what order the libraries are added, +// they end up in the order that agrees with PackageManager. +func TestCLCSdkVersionOrder(t *testing.T) { + ctx := testContext() + m := make(ClassLoaderContextMap) + m.AddContext(ctx, 28, "a", buildPath(ctx, "a"), installPath(ctx, "a"), nil) + m.AddContext(ctx, 29, "b", buildPath(ctx, "b"), installPath(ctx, "b"), nil) + m.AddContext(ctx, 30, "c", buildPath(ctx, "c"), installPath(ctx, "c"), nil) + m.AddContext(ctx, AnySdkVersion, "d", buildPath(ctx, "d"), installPath(ctx, "d"), nil) + + valid, validationError := validateClassLoaderContext(m) + + fixClassLoaderContext(m) + + var haveStr string + if valid && validationError == nil { + haveStr, _ = ComputeClassLoaderContext(m) + } + + // Test that validation is successful (all paths are known). + t.Run("validate", func(t *testing.T) { + if !(valid && validationError == nil) { + t.Errorf("invalid class loader context") + } + }) + + // Test that class loader context structure is correct. + t.Run("string", func(t *testing.T) { + wantStr := " --host-context-for-sdk 30 PCL[out/c.jar]" + + " --target-context-for-sdk 30 PCL[/system/c.jar]" + + " --host-context-for-sdk 29 PCL[out/b.jar]" + + " --target-context-for-sdk 29 PCL[/system/b.jar]" + + " --host-context-for-sdk 28 PCL[out/a.jar]" + + " --target-context-for-sdk 28 PCL[/system/a.jar]" + + " --host-context-for-sdk any PCL[out/d.jar]" + + " --target-context-for-sdk any PCL[/system/d.jar]" + if wantStr != haveStr { + t.Errorf("\nwant class loader context: %s\nhave class loader context: %s", wantStr, haveStr) + } + }) +} + +func checkError(t *testing.T, have error, want string) { + if have == nil { + t.Errorf("\nwant error: '%s'\nhave: none", want) + } else if msg := have.Error(); !strings.HasPrefix(msg, want) { + t.Errorf("\nwant error: '%s'\nhave error: '%s'\n", want, msg) + } +} + +func testContext() android.ModuleInstallPathContext { + config := android.TestConfig("out", nil, "", nil) + return android.ModuleInstallPathContextForTesting(config) +} + +func buildPath(ctx android.PathContext, lib string) android.Path { + return android.PathForOutput(ctx, lib+".jar") +} + +func installPath(ctx android.ModuleInstallPathContext, lib string) android.InstallPath { + return android.PathForModuleInstall(ctx, lib+".jar") +} |