Quelle  install_symlink.go   Sprache: unbekannt

// Copyright 2023 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 etc

import (
 "android/soong/android"
 "path/filepath"
 "strings"

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

func init() {
 RegisterInstallSymlinkBuildComponents(android.InitRegistrationContext)
}

func RegisterInstallSymlinkBuildComponents(ctx android.RegistrationContext) {
 ctx.RegisterModuleType("install_symlink", InstallSymlinkFactory)
 ctx.RegisterModuleType("install_symlink_host", InstallSymlinkHostFactory)
}

// install_symlink can be used to install an symlink with an arbitrary target to an arbitrary path
// on the device.
func InstallSymlinkFactory() android.Module {
 module := &InstallSymlink{}
 module.AddProperties(&module.properties)
 android.InitAndroidMultiTargetsArchModule(module, android.DeviceSupported, android.MultilibCommon)
 return module
}

// install_symlink can be used to install an symlink to an arbitrary path on the host.
func InstallSymlinkHostFactory() android.Module {
 module := &InstallSymlink{}
 module.AddProperties(&module.properties)
 android.InitAndroidMultiTargetsArchModule(module, android.HostSupported, android.MultilibCommon)
 return module
}

type InstallSymlinkProperties struct {
 // Where to install this symlink, relative to the partition it's installed on.
 // Which partition it's installed on can be controlled by the vendor, system_ext, ramdisk, etc.
 // properties.
 Installed_location string
 // The target of the symlink, aka where the symlink points.
 Symlink_target proptools.Configurable[string]
}

type InstallSymlink struct {
 android.ModuleBase
 properties InstallSymlinkProperties

 output        android.Path
 installedPath android.InstallPath
}

func (m *InstallSymlink) GenerateAndroidBuildActions(ctx android.ModuleContext) {
 symlink_target := m.properties.Symlink_target.GetOrDefault(ctx, "")
 if filepath.Clean(symlink_target) != symlink_target {
  ctx.PropertyErrorf("symlink_target", "Should be a clean filepath")
  return
 }
 if filepath.Clean(m.properties.Installed_location) != m.properties.Installed_location {
  ctx.PropertyErrorf("installed_location", "Should be a clean filepath")
  return
 }
 if strings.HasPrefix(m.properties.Installed_location, "../") || strings.HasPrefix(m.properties.Installed_location, "/") {
  ctx.PropertyErrorf("installed_location", "Should not start with / or ../")
  return
 }

 out := android.PathForModuleOut(ctx, "out.txt")
 android.WriteFileRuleVerbatim(ctx, out, "")
 m.output = out

 name := filepath.Base(m.properties.Installed_location)
 installDir := android.PathForModuleInstall(ctx, filepath.Dir(m.properties.Installed_location))
 m.installedPath = ctx.InstallAbsoluteSymlink(installDir, name, symlink_target)

 moduleInfoJSON := ctx.ModuleInfoJSON()
 moduleInfoJSON.Class = []string{"FAKE"}
 moduleInfoJSON.SystemSharedLibs = []string{"none"}
}

func (m *InstallSymlink) AndroidMkEntries() []android.AndroidMkEntries {
 return []android.AndroidMkEntries{{
  Class: "FAKE",
  // Need at least one output file in order for this to take effect.
  OutputFile: android.OptionalPathForPath(m.output),
  Include:    "$(BUILD_PHONY_PACKAGE)",
  ExtraEntries: []android.AndroidMkExtraEntriesFunc{
   func(ctx android.AndroidMkExtraEntriesContext, entries *android.AndroidMkEntries) {
    entries.AddStrings("LOCAL_SOONG_INSTALL_SYMLINKS", m.installedPath.String())
   },
  },
 }}
}