Files
HomeAgent/internal/plugin/dynamic_loader_unix.go
jianf 4da2ad5376 feat: multi-platform .hmap bundle + platform auto-selection
- PluginManifest: add platforms field declaring supported OS
- validatePackage: accept bundle .hmap with platform-aware binary check
- extractPackage: extract only current OS binary, skip others (macOS renames .dylib → .so)
- installFromPath/installFromURL: path install keeps source, URL install auto-cleanup
- cabi/loader.go + dynamic.go: add linux/darwin build constraints for Windows cross-compile
- dynamic_loader_unix/windows: split SO loading with proper build tags
- package/build.sh: enable windows/amd64 for homed, add CXX export for arm64
- tryLoadSO: fallback to plugin.dylib on macOS
- docs: update PLUGIN_DEV.md for bundle format and install methods
2026-07-19 12:01:35 +08:00

120 lines
3.1 KiB
Go

//go:build linux || darwin
package plugin
import (
"crypto/sha256"
"encoding/hex"
"encoding/json"
"fmt"
"os"
"path/filepath"
"plugin"
"reflect"
pubsdk "gitcode.com/JianFeeeee/homeagent-sdk/sdk"
sdk "gitcode.com/JianFeeeee/HomeAgent/internal/sdk"
"gitcode.com/JianFeeeee/HomeAgent/internal/plugin/cabi"
)
type dynamicPlugin struct {
name string
impl pubsdk.Plugin
}
func (p *dynamicPlugin) Name() string { return p.name }
func (p *dynamicPlugin) Start(s *sdk.PluginSDK) error {
return p.impl.Start(s.PluginSDK)
}
func (p *dynamicPlugin) Stop() error { return p.impl.Stop() }
type cabiPlugin struct {
name string
handle *cabi.Handle
}
func (p *cabiPlugin) Name() string { return p.name }
func (p *cabiPlugin) Start(s *sdk.PluginSDK) error {
corePtr := p.handle.CreateCoreAPI(s)
if corePtr == nil {
return fmt.Errorf("cabi: failed to create CoreAPI for %s", p.name)
}
if err := p.handle.Start(corePtr); err != nil {
return fmt.Errorf("cabi: start %s: %w", p.name, err)
}
return nil
}
func (p *cabiPlugin) Stop() error {
_ = p.handle.Stop()
return nil
}
func tryLoadSO(dir, name string, config map[string]interface{}) (sdk.Plugin, error) {
soPath := filepath.Join(dir, soEntry)
if _, err := os.Stat(soPath); os.IsNotExist(err) {
// 回退尝试 plugin.dylib (macOS 原生扩展名)
dylibPath := filepath.Join(dir, "plugin.dylib")
if _, err2 := os.Stat(dylibPath); err2 == nil {
soPath = dylibPath
} else {
return nil, nil
}
}
handle, err := cabi.Load(soPath, name, config)
if err == nil {
return &cabiPlugin{name: name, handle: handle}, nil
}
data, err := os.ReadFile(soPath)
if err != nil {
return nil, fmt.Errorf("read %s: %w", soPath, err)
}
h := sha256.Sum256(data)
cacheKey := fmt.Sprintf("plugin_%s_%s.so", name, hex.EncodeToString(h[:8]))
cachePath := filepath.Join(os.TempDir(), cacheKey)
if _, err := os.Stat(cachePath); os.IsNotExist(err) {
if err := os.WriteFile(cachePath, data, 0644); err != nil {
return nil, fmt.Errorf("write cache %s: %w", cachePath, err)
}
}
p, err := plugin.Open(cachePath)
if err != nil {
return nil, fmt.Errorf("plugin.Open %s: %w", cachePath, err)
}
sym, err := p.Lookup("NewPlugin")
if err != nil {
return nil, fmt.Errorf(".so %s must export NewPlugin: %w", soPath, err)
}
rv := reflect.ValueOf(sym)
if rv.Kind() != reflect.Func {
return nil, fmt.Errorf("NewPlugin in %s is not a function (type=%T)", soPath, sym)
}
if rv.Type().NumIn() != 2 || rv.Type().NumOut() != 2 {
return nil, fmt.Errorf("NewPlugin in %s has wrong arity", soPath)
}
outs := rv.Call([]reflect.Value{reflect.ValueOf(name), reflect.ValueOf(config)})
if len(outs) != 2 {
return nil, fmt.Errorf("NewPlugin in %s returned unexpected values", soPath)
}
if !outs[1].IsNil() {
if err, ok := outs[1].Interface().(error); ok {
return nil, fmt.Errorf("NewPlugin %s: %w", name, err)
}
return nil, fmt.Errorf("NewPlugin %s returned non-error second value", name)
}
plg, ok := outs[0].Interface().(pubsdk.Plugin)
if !ok {
return nil, fmt.Errorf("NewPlugin in %s does not implement pubsdk.Plugin", soPath)
}
return &dynamicPlugin{name: name, impl: plg}, nil
}
var _ = json.Marshal