AAventa Developer

Complete Example Plugin

一个经过当前公开合同验证、可下载并逐文件阅读的原生插件。

Docs 0.1.0-dev.1Updated 2026-08-30PUBLIC

# 下载与使用

下载 example-greeting.zip 查看 manifest.json

  1. 下载并解压。
  2. 把目录名改成你的包名。
  3. 同步修改 manifest id/version/entrypoint、PHP namespace 和 owned namespace。
  4. 只声明真实需要的 capability、事件和资源。
  5. 运行主机选定的工程校验;不要自行声明校验状态。

# 完整文件树

example-greeting/
├── README.md
├── manifest.json
├── migrations.php
├── assets/greeting.css
├── src/GreetingRegistrar.php
├── src/GreetingService.php
└── templates/greeting.php

# Manifest

示例 manifest 使用 business-module,声明四个实际使用的 capability、一个事件、一个数据 namespace、一个不可变迁移、一个模板和一个资源。打开原始文件

# Registrar

Registrar 只声明事件、生命周期、模板、资源和配置 validator。打开完整 PHP 源码

# Runtime service

服务只通过 RuntimeContext 使用配置、自有数据、缓存和日志。打开完整 PHP 源码

# Migration

迁移使用真实 Migration 构造器和声明一致的 checksum;幂等地写入默认值。打开完整 PHP 源码

# 已执行校验

构建流程会检查 PHP 语法、manifest closed-world 合同、能力与包类型矩阵、迁移 metadata/对象一致性、Registrar 接口、包安装/启用、真实事件调用、数据 namespace 归属、资源存在性、ZIP 内容和公开边界。任何一项失败都会停止发布。