ET框架插件开发终极指南：Unity Package本地链接技巧详解

童香莺Wyman

507人浏览 · 2026-02-24 03:33:54

童香莺Wyman · 2026-02-24 03:33:54 发布

ET框架插件开发终极指南：Unity Package本地链接技巧详解

【免费下载链接】ET Unity3D 客户端和 C# 服务器框架。项目地址: https://gitcode.com/GitHub_Trending/et/ET

ET框架作为Unity3D客户端和C#服务器框架，其插件开发需要掌握Unity Package的本地链接技术。本文将详细介绍ET框架插件开发中Unity Package本地链接的核心技巧，帮助开发者快速实现插件的本地调试与开发。

一、Unity Package本地链接基础

Unity Package本地链接是插件开发的关键技术，通过本地链接可以直接引用本地开发的Package，避免反复打包发布的繁琐流程。在ET框架中，Package的规范遵循标准的Unity Package格式，同时具有ET特有的目录结构要求。

ET Package的目录格式为cn.etetet.+包名，例如cn.etetet.core。这种命名规范确保了Package的唯一性和可识别性。Package本质上是npm包，在package.json中需要添加发布配置，指定GitHub Packages的 registry，具体配置如下：

"publishConfig":
{
   "registry": "https://npm.pkg.github.com/@ET-Packages"
}

二、本地链接的核心配置步骤

2.1 准备Package目录结构

ET Package具有特定的目录结构，主要包括以下关键目录：

Scripts：放置Model、Hotfix、ModelView、HotfixView代码，支持热更新，包含Server、Client、Share子目录，分别对应服务端、客户端和双端共用代码。
Runtime：放置AOT代码，需定义asmdef程序集，通常命名为ET.Core等格式。
Editor：存放Editor代码，命名格式如ET.Core.Editor。

每个Package在顶层需放置一个Ignore的asmdef，确保默认情况下代码不生效，只有添加特定asmdef后才会启用。

2.2 配置本地链接路径

在Unity中配置本地链接需要通过Package Manager的Scoped Registry设置。打开Unity的Package Manager，选择"Add package from git URL..."，输入本地Package的路径。或者通过编辑Packages/manifest.json文件，添加本地Package的依赖路径，例如：

"dependencies": {
  "cn.etetet.core": "file:../path/to/your/local/package"
}

2.3 处理外部工具设置

Unity的External Tools设置对Package的链接和项目文件生成至关重要。在"Edit > Preferences > External Tools"中，确保"Generate .csproj files for"选项下的"Local packages"已勾选，这样Unity会为本地链接的Package生成必要的项目文件，方便在IDE中进行调试和开发。

三、高级链接技巧与注意事项

3.1 使用packagegit.json管理依赖

每个ET Package需包含packagegit.json文件，用于定义包的Id、名称以及Git依赖。通过该文件可以配置包之间的依赖关系，例如引用其他Git包。具体配置可参考cn.etetet.core包中的packagegit.json文件。

3.2 处理代码引用与宏定义

Model、ModelView、Hotfix、HotfixView目录中的代码引用需要通过packagegit.json中的依赖配置来管理。运行ET菜单中的"ET->Refresh"命令，可以将所有引用设置到demo的四个程序集引用中。对于demo包，需要为这四个asmdef添加INITED宏，只有在运行"ET->Init"后才会生效，避免初始下载时出错。

3.3 本地调试与热更新

本地链接的Package支持实时修改和调试，修改后的代码无需重新打包，Unity会自动检测并编译。结合ET框架的热更新机制，可以快速测试插件功能，提高开发效率。

四、ET Package制作指南参考

ET框架提供了详细的Package制作指南，位于Book/8.1ET Package制作指南.md。该指南涵盖了Package的规范、目录结构、发布流程等内容，是插件开发的重要参考资料。其中提到，Package的制作者可以通过GitHub Actions实现自动打包发布，具体步骤如下：

在包的根目录添加.github/workflows/release-package.yml文件，可从https://github.com/ET-Packages/cn.etetet.yiui/tree/master/.github/workflows复制。
在GitHub仓库中，进入Actions，选择"ET Package" Action，点击"Run workflow"即可制作Package。