Read this manual in English

库

库实现了项目间共享资源. 在工作流中使用库方便而更有效率.

库在以下情形下很有用:

• 把已完成项目的资源复制到新建项目里使用. 如果要为你的游戏出续集, 很需要这种方法.
• 编译一个模板的库以便导入到项目中再定制使用.
• 编译一些包含做好了的对象和脚本的库以便直接使用. 对于保存通用脚本模块或者创建共享资源非常有用.

库共享设置

比如你想创建一个包含共享 sprite 和瓷砖图源的库. 先从 新建项目设置 开始. 确定项目中你要共享的文件夹然后把它加入到项目设置的 include_dirs 属性列表里. 如果需要加入多个, 以空格分隔文件夹名称:

我们需要先定位库才能把它导入到项目里.

库地址

库使用标准 URL 来引用. 对于托管在 GitHub 上的项目, 就是项目发布的 URL:

基本訪問驗證

對於不公開的庫可以通過在 URL 上加入用戶名密碼 / 訪問權token的方法來訪問:

https://username:password@github.com/defold/private/archive/main.zip

這裏 username 和 password 項會被提取並轉化爲 Authorization 請求頭. 這種方法一般服務器都適用. 包括從 GitHub 上獲取私有庫. GitHub 還支持使用 生成訪問權token 的方法來代替密碼.

https://github-username:personal-access-token@github.com/defold/private/archive/main.zip

为避免泄密在库 URL 上的明文用户名密码字符串可以使用环境变量代替:

https://__PRIVATE_USERNAME__:__PRIVATE_TOKEN__@github.com/defold/private/archive/main.zip

上面的例子里用户名和令牌会被替换为环境变量 PRIVATE_USERNAME 和 PRIVATE_TOKEN 的值.

严格访问权限

基本訪問权限下token和用户名都在项目依赖库上公开. 这对于多人开发团队来说可能会造成麻烦. 解决办法是给库引入一个 “只读” 用户, 在 GitHub 上可以设置一个机构, 一个团队以及一个不需要编辑代码的用户 (也就是只读用户).

GitHub 具体步骤:

• 创建机构
• 机构之下的团队
• 把需要的私有库存放到机构之下
• 将开发团队设置为对库 “只读”
• 创建只读团队的只读用户成员
• 给只读用户发放 “基本访问权限” token

此时这个只读用户的信息就可以放心公开在依赖库上. 这样就可以将私有库公开化而不用担心被恶意篡改.

上述解决方案于 Defold 论坛提出并 于此帖子上进行谈论.

设置库依赖

打开需要引入库的项目. 在项目设置里, 把 URL 加入到 dependencies 属性下. 如果需要可以加入多个. 使用 + 按钮一个一个加入, 使用 - 按钮移除:

然后, 选择 Project ▸ Fetch Libraries 来更新库依赖. 这项工作会在打开项目时自动执行所以只有当库需要更新而不想重新打开项目时才会用到这个命令. 比如你修改了库依赖或者库本身被修改和同步了的时候.

此时你共享的文件夹就会出现在资源面板中等待使用. 库的各种修改都会同步到你的项目之中.

引用破坏

共享库仅限于使用共享文件夹下的文件. 如果你引用了共享文件夹之外的资源, 则共享引用就会被破坏.

命名冲突

如果项目设置 dependencies 中引用了很多库你可能会遇到命名冲突的情况. 如果两个或者多个项目的项目设置中 include_dirs 里包含的共享文件夹名一样就会造成这种情况.

Defold 解决库命名冲突的办法很简单, 除了 dependencies 列表中最后一个, 其他都忽略掉. 比如说. 你的项目依赖3个库, 每个库都有一个叫做 items 的共享文件夹, 则只有一个 items 文件夹会被显示出来—那就是处于 URL 列表里的最后一个.