Eine aufbereitete Darstellung der Quelle

 
     
 
 
Anforderungen  |   Konzepte  |   Entwurf  |   Entwicklung  |   Qualitätssicherung  |   Lebenszyklus  |   Steuerung
 
 
 
 

Benutzer

Quelle  droidstubs_test.go   Sprache: unbekannt

 
Spracherkennung für: .go vermutete Sprache: Unknown {[0] [0] [0]} [Methode: Schwerpunktbildung, einfache Gewichte, sechs Dimensionen]

// Copyright 2021 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"
 "reflect"
 "regexp"
 "strings"
 "testing"

 "android/soong/android"

 "github.com/google/blueprint/proptools"
)

func TestDroidstubs(t *testing.T) {
 t.Parallel()
 ctx, _ := testJavaWithFS(t, `
  droiddoc_exported_dir {
   name: "droiddoc-templates-sdk",
   path: ".",
  }

  droidstubs {
   name: "bar-stubs",
   srcs: ["bar-doc/a.java"],
   api_levels_annotations_dirs: ["droiddoc-templates-sdk"],
   api_levels_annotations_enabled: true,
  }

  droidstubs {
   name: "bar-stubs-other",
   srcs: ["bar-doc/a.java"],
   high_mem: true,
   api_levels_annotations_dirs: ["droiddoc-templates-sdk"],
   api_levels_annotations_enabled: true,
   api_levels_jar_filename: "android.other.jar",
  }

  droidstubs {
   name: "stubs-applying-api-versions",
   srcs: ["bar-doc/a.java"],
   api_levels_module: "bar-stubs-other",
  }
  `,
  map[string][]byte{
   "bar-doc/a.java": nil,
  })
 testcases := []struct {
  moduleName          string
  expectedJarFilename string
  generate_xml        bool
  high_mem            bool
 }{
  {
   moduleName:          "bar-stubs",
   generate_xml:        true,
   expectedJarFilename: "android.jar",
   high_mem:            false,
  },
  {
   moduleName:          "bar-stubs-other",
   generate_xml:        true,
   expectedJarFilename: "android.other.jar",
   high_mem:            true,
  },
  {
   moduleName:   "stubs-applying-api-versions",
   generate_xml: false,
  },
 }
 for _, c := range testcases {
  m := ctx.ModuleForTests(t, c.moduleName, "android_common")
  manifest := m.Output("metalava.sbox.textproto")
  sboxProto := android.RuleBuilderSboxProtoForTests(t, ctx, manifest)
  cmdline := String(sboxProto.Commands[0].Command)
  android.AssertStringContainsEquals(t, "api-versions generation flag", cmdline, "--generate-api-levels", c.generate_xml)
  if c.expectedJarFilename != "" {
   expected := "--android-jar-pattern ./{version:major.minor?}/public/" + c.expectedJarFilename
   if !strings.Contains(cmdline, expected) {
    t.Errorf("For %q, expected metalava argument %q, but was not found %q", c.moduleName, expected, cmdline)
   }
  }

  metalava := m.Rule("metalava")
  rp := metalava.RuleParams
  if actual := rp.Pool != nil && strings.Contains(rp.Pool.String(), "highmem"); actual != c.high_mem {
   t.Errorf("Expected %q high_mem to be %v, was %v", c.moduleName, c.high_mem, actual)
  }
 }
}

// runs a test for droidstubs with a customizable sdkType argument and returns
// the list of jar patterns that is passed as `--android-jar-pattern`
func getAndroidJarPatternsForDroidstubs(t *testing.T, sdkType string) []string {
 ctx, _ := testJavaWithFS(t, fmt.Sprintf(`
  droiddoc_exported_dir {
   name: "some-exported-dir",
   path: "somedir",
  }

  droiddoc_exported_dir {
   name: "some-other-exported-dir",
   path: "someotherdir",
  }

  droidstubs {
   name: "foo-stubs",
   srcs: ["foo-doc/a.java"],
   api_levels_annotations_dirs: [
    "some-exported-dir",
    "some-other-exported-dir",
   ],
   api_levels_annotations_enabled: true,
   api_levels_sdk_type: "%s",
  }
  `, sdkType),
  map[string][]byte{
   "foo-doc/a.java": nil,
  })

 m := ctx.ModuleForTests(t, "foo-stubs", "android_common")
 manifest := m.Output("metalava.sbox.textproto")
 cmd := String(android.RuleBuilderSboxProtoForTests(t, ctx, manifest).Commands[0].Command)
 r := regexp.MustCompile(`--android-jar-pattern [^ ]+/android.jar`)
 return r.FindAllString(cmd, -1)
}

func TestPublicDroidstubs(t *testing.T) {
 t.Parallel()
 patterns := getAndroidJarPatternsForDroidstubs(t, "public")

 android.AssertArrayString(t, "order of patterns", []string{
  "--android-jar-pattern somedir/{version:major.minor?}/public/android.jar",
  "--android-jar-pattern someotherdir/{version:major.minor?}/public/android.jar",
 }, patterns)
}

func TestSystemDroidstubs(t *testing.T) {
 t.Parallel()
 patterns := getAndroidJarPatternsForDroidstubs(t, "system")

 android.AssertArrayString(t, "order of patterns", []string{
  "--android-jar-pattern somedir/{version:major.minor?}/system/android.jar",
  "--android-jar-pattern someotherdir/{version:major.minor?}/system/android.jar",
  "--android-jar-pattern somedir/{version:major.minor?}/public/android.jar",
  "--android-jar-pattern someotherdir/{version:major.minor?}/public/android.jar",
 }, patterns)
}

func TestModuleLibDroidstubs(t *testing.T) {
 t.Parallel()
 patterns := getAndroidJarPatternsForDroidstubs(t, "module-lib")

 android.AssertArrayString(t, "order of patterns", []string{
  "--android-jar-pattern somedir/{version:major.minor?}/module-lib/android.jar",
  "--android-jar-pattern someotherdir/{version:major.minor?}/module-lib/android.jar",
  "--android-jar-pattern somedir/{version:major.minor?}/system/android.jar",
  "--android-jar-pattern someotherdir/{version:major.minor?}/system/android.jar",
  "--android-jar-pattern somedir/{version:major.minor?}/public/android.jar",
  "--android-jar-pattern someotherdir/{version:major.minor?}/public/android.jar",
 }, patterns)
}

func TestSystemServerDroidstubs(t *testing.T) {
 patterns := getAndroidJarPatternsForDroidstubs(t, "system-server")

 android.AssertArrayString(t, "order of patterns", []string{
  "--android-jar-pattern somedir/{version:major.minor?}/system-server/android.jar",
  "--android-jar-pattern someotherdir/{version:major.minor?}/system-server/android.jar",
  "--android-jar-pattern somedir/{version:major.minor?}/module-lib/android.jar",
  "--android-jar-pattern someotherdir/{version:major.minor?}/module-lib/android.jar",
  "--android-jar-pattern somedir/{version:major.minor?}/system/android.jar",
  "--android-jar-pattern someotherdir/{version:major.minor?}/system/android.jar",
  "--android-jar-pattern somedir/{version:major.minor?}/public/android.jar",
  "--android-jar-pattern someotherdir/{version:major.minor?}/public/android.jar",
 }, patterns)
}

func TestDroidstubsSandbox(t *testing.T) {
 ctx, _ := testJavaWithFS(t, `
  genrule {
   name: "foo",
   out: ["foo.txt"],
   cmd: "touch $(out)",
  }

  droidstubs {
   name: "bar-stubs",
   srcs: ["bar-doc/a.java"],

   args: "--reference $(location :foo)",
   arg_files: [":foo"],
  }
  `,
  map[string][]byte{
   "bar-doc/a.java": nil,
  })

 m := ctx.ModuleForTests(t, "bar-stubs", "android_common")
 metalava := m.Rule("metalava")
 if g, w := metalava.Inputs.Strings(), []string{"bar-doc/a.java"}; !reflect.DeepEqual(w, g) {
  t.Errorf("Expected inputs %q, got %q", w, g)
 }

 manifest := android.RuleBuilderSboxProtoForTests(t, ctx, m.Output("metalava.sbox.textproto"))
 if g, w := manifest.Commands[0].GetCommand(), "reference __SBOX_SANDBOX_DIR__/out/soong/.intermediates/foo/gen/foo.txt"; !strings.Contains(g, w) {
  t.Errorf("Expected command to contain %q, got %q", w, g)
 }
}

func TestDroidstubsWithSystemModules(t *testing.T) {
 ctx, _ := testJava(t, `
  droidstubs {
      name: "stubs-source-system-modules",
      srcs: [
          "bar-doc/a.java",
      ],
    sdk_version: "none",
    system_modules: "source-system-modules",
  }

  java_library {
    name: "source-jar",
      srcs: [
          "a.java",
      ],
  }

  java_system_modules {
    name: "source-system-modules",
    libs: ["source-jar"],
  }

  droidstubs {
      name: "stubs-prebuilt-system-modules",
      srcs: [
          "bar-doc/a.java",
      ],
    sdk_version: "none",
    system_modules: "prebuilt-system-modules",
  }

  java_import {
    name: "prebuilt-jar",
    jars: ["a.jar"],
  }

  java_system_modules_import {
    name: "prebuilt-system-modules",
    libs: ["prebuilt-jar"],
  }
  `)

 checkSystemModulesUseByDroidstubs(t, ctx, "stubs-source-system-modules", "source-jar.jar")

 checkSystemModulesUseByDroidstubs(t, ctx, "stubs-prebuilt-system-modules", "prebuilt-jar.jar")
}

func checkSystemModulesUseByDroidstubs(t *testing.T, ctx *android.TestContext, moduleName string, systemJar string) {
 metalavaRule := ctx.ModuleForTests(t, moduleName, "android_common").Rule("metalava")
 var systemJars []string
 for _, i := range metalavaRule.Implicits {
  systemJars = append(systemJars, i.Base())
 }
 if len(systemJars) < 1 || systemJars[0] != systemJar {
  t.Errorf("inputs of %q must be []string{%q}, but was %#v.", moduleName, systemJar, systemJars)
 }
}

func TestDroidstubsWithSdkExtensions(t *testing.T) {
 ctx, _ := testJavaWithFS(t, `
  droiddoc_exported_dir {
   name: "sdk-dir",
   path: "sdk",
  }

  droidstubs {
   name: "baz-stubs",
   api_levels_annotations_dirs: ["sdk-dir"],
   api_levels_annotations_enabled: true,
   extensions_info_file: ":info-file",
  }

  filegroup {
   name: "info-file",
   srcs: ["sdk/extensions/info.txt"],
  }
  `,
  map[string][]byte{
   "sdk/extensions/1/public/some-mainline-module-stubs.jar": nil,
   "sdk/extensions/info.txt":                                nil,
  })
 m := ctx.ModuleForTests(t, "baz-stubs", "android_common")
 manifest := m.Output("metalava.sbox.textproto")
 cmdline := String(android.RuleBuilderSboxProtoForTests(t, ctx, manifest).Commands[0].Command)
 android.AssertStringDoesContain(t, "android-jar-pattern present", cmdline, "--android-jar-pattern sdk/extensions/{version:extension}/public/{module}.jar")
 android.AssertStringDoesContain(t, "sdk-extensions-info present", cmdline, "--sdk-extensions-info sdk/extensions/info.txt")
}

func TestDroidStubsApiContributionGeneration(t *testing.T) {
 ctx, _ := testJavaWithFS(t, `
  droidstubs {
   name: "foo",
   srcs: ["A/a.java"],
   api_surface: "public",
   check_api: {
    current: {
     api_file: "A/current.txt",
     removed_api_file: "A/removed.txt",
    }
   }
  }
  `,
  map[string][]byte{
   "A/a.java":      nil,
   "A/current.txt": nil,
   "A/removed.txt": nil,
  },
 )

 ctx.ModuleForTests(t, "foo.api.contribution", "")
}

func TestGeneratedApiContributionVisibilityTest(t *testing.T) {
 library_bp := `
  java_api_library {
   name: "bar",
   api_surface: "public",
   api_contributions: ["foo.api.contribution"],
   stubs_type: "everything",
  }
 `
 ctx, _ := testJavaWithFS(t, `
   droidstubs {
    name: "foo",
    srcs: ["A/a.java"],
    api_surface: "public",
    check_api: {
     current: {
      api_file: "A/current.txt",
      removed_api_file: "A/removed.txt",
     }
    },
    visibility: ["//a", "//b"],
   }
  `,
  map[string][]byte{
   "a/a.java":      nil,
   "a/current.txt": nil,
   "a/removed.txt": nil,
   "b/Android.bp":  []byte(library_bp),
  },
 )

 ctx.ModuleForTests(t, "bar", "android_common")
}

func TestAconfigDeclarations(t *testing.T) {
 result := android.GroupFixturePreparers(
  prepareForJavaTest,
  android.FixtureModifyProductVariables(func(variables android.FixtureProductVariables) {
  }),
  android.FixtureMergeMockFs(map[string][]byte{
   "a/A.java":      nil,
   "a/current.txt": nil,
   "a/removed.txt": nil,
  }),
 ).RunTestWithBp(t, `
 aconfig_declarations {
  name: "bar",
  package: "com.example.package",
  container: "com.android.foo",
  srcs: [
   "bar.aconfig",
  ],
 }
 droidstubs {
  name: "foo",
  srcs: ["a/A.java"],
  api_surface: "public",
  check_api: {
   current: {
    api_file: "a/current.txt",
    removed_api_file: "a/removed.txt",
   }
  },
  aconfig_declarations: [
   "bar",
  ],
 }
 `)

 // Check that droidstubs depend on aconfig_declarations
 android.AssertBoolEquals(t, "foo expected to depend on bar",
  CheckModuleHasDependency(t, result.TestContext, "foo", "android_common", "bar"), true)

 m := result.ModuleForTests(t, "foo", "android_common")
 android.AssertStringDoesContain(t, "foo generates revert annotations file",
  strings.Join(m.AllOutputs(), ""), "flags-config-exportable.xml")

 // revert-annotations.txt passed to exportable stubs generation metalava command
 manifest := m.Output("metalava_exportable.sbox.textproto")
 cmdline := String(android.RuleBuilderSboxProtoForTests(t, result.TestContext, manifest).Commands[0].Command)
 android.AssertStringDoesContain(t, "flagged api hide command not included", cmdline, "flags-config-exportable.xml")

 android.AssertStringDoesContain(t, "foo generates exportable stubs jar",
  strings.Join(m.AllOutputs(), ""), "exportable/foo-stubs.srcjar")
}

func TestReleaseExportRuntimeApis(t *testing.T) {
 result := android.GroupFixturePreparers(
  prepareForJavaTest,
  android.FixtureModifyProductVariables(func(variables android.FixtureProductVariables) {
   variables.ExportRuntimeApis = proptools.BoolPtr(true)
  }),
  android.PrepareForTestWithBuildFlag("RELEASE_HIDDEN_API_EXPORTABLE_STUBS", "true"),
  android.FixtureMergeMockFs(map[string][]byte{
   "a/A.java":      nil,
   "a/current.txt": nil,
   "a/removed.txt": nil,
  }),
 ).RunTestWithBp(t, `
 aconfig_declarations {
  name: "bar",
  package: "com.example.package",
  container: "com.android.foo",
  srcs: [
   "bar.aconfig",
  ],
 }
 droidstubs {
  name: "foo",
  srcs: ["a/A.java"],
  api_surface: "public",
  check_api: {
   current: {
    api_file: "a/current.txt",
    removed_api_file: "a/removed.txt",
   }
  },
  aconfig_declarations: [
   "bar",
  ],
 }
 `)

 m := result.ModuleForTests(t, "foo", "android_common")

 rule := m.Output("released-flags-exportable.pb")
 exposeWritableApisFilter := "--filter='state:ENABLED+permission:READ_ONLY' --filter='permission:READ_WRITE'"
 android.AssertStringEquals(t, "Filter argument expected to contain READ_WRITE permissions", exposeWritableApisFilter, rule.Args["filter_args"])
}

[Dauer der Verarbeitung: 0.49 Sekunden, vorverarbeitet 2026-06-28]

                                                                                                                                                                                                                                                                                                                                                                                                     


Neuigkeiten

     Aktuelles
     Motto des Tages

Software

     Quellcodebibliothek
     Eigene Quellcodes
     Fremde Quellcodes
     Suchen

Aktivitäten

     Artikel über Sicherheit
     Anleitung zur Aktivierung von SSL

Muße

     Gedichte
     Musik
     Bilder

Jenseits des Üblichen ....
    

Besucherstatistik

Besucherstatistik