mirror of https://github.com/tuyoogame/YooAsset
delete docs
hevinci
parent
396ec7121c
commit
5c59cfe983
|
|
@ -1,163 +0,0 @@
|
|||
# 资源构建
|
||||
|
||||
|
||||
|
||||
### 界面介绍
|
||||
|
||||
- **Build Output**
|
||||
|
||||
构建输出的目录，会根据Unity编辑器当前切换的平台自动划分构建结果。
|
||||
|
||||
- **Build Pipeline**
|
||||
|
||||
构建管线
|
||||
|
||||
(1) BuiltinBuildPipeline: 传统的内置构建管线。
|
||||
|
||||
(2) ScriptableBuildPipeline: 可编程构建管线。
|
||||
|
||||
- **Build Mode**
|
||||
|
||||
构建模式
|
||||
|
||||
(1) 强制构建模式：会删除指定构建平台下的所有构建记录，重新构建所有资源包。
|
||||
|
||||
(2) 增量构建模式：以上一次构建结果为基础，对于发生变化的资源进行增量构建。
|
||||
|
||||
(3) 演练构建模式：在不生成AssetBundle文件的前提下，进行演练构建并快速生成构建报告和补丁清单。
|
||||
|
||||
(4) 模拟构建模式：在编辑器下配合EditorSimulateMode运行模式，来模拟真实运行的环境。
|
||||
|
||||
- **Build Version**
|
||||
|
||||
构建的资源包版本。
|
||||
|
||||
- **Build Package**
|
||||
|
||||
构建的资源包名称。
|
||||
|
||||
- **Encryption**
|
||||
|
||||
加密类列表。
|
||||
|
||||
- **Compression**
|
||||
|
||||
资源包的压缩方式。
|
||||
|
||||
- **Output Name Style**
|
||||
|
||||
输出的资源包文件名称样式
|
||||
|
||||
HashName：哈希值
|
||||
|
||||
BundleName_HashName：资源包名+哈希值
|
||||
|
||||
- **Copy Buildin File Option**
|
||||
|
||||
首包资源文件的拷贝方式
|
||||
|
||||
(1) None：不拷贝任何文件
|
||||
|
||||
(2) ClearAndCopyAll：先清空已有文件，然后拷贝所有文件
|
||||
|
||||
(3) ClearAndCopyByTags：先清空已有文件，然后按照资源标签拷贝文件
|
||||
|
||||
(4) OnlyCopyAll：不清空已有文件，直接拷贝所有文件
|
||||
|
||||
(5) OnlyCopyByTags：不清空已有文件，直接按照资源标签拷贝文件
|
||||
|
||||
- **构建**
|
||||
|
||||
点击构建按钮会开始构建流程，构建流程分为多个节点顺序执行，如果某个节点发生错误，会导致构建失败。错误信息可以在控制台查看。
|
||||
|
||||
### 补丁包
|
||||
|
||||
构建成功后会在输出目录下找到补丁包文件夹，该文件夹名称为本次构建时指定的资源版本号。
|
||||
|
||||
补丁包文件夹里包含补丁清单文件，资源包文件，构建报告文件等。
|
||||
|
||||
|
||||
|
||||
### 补丁清单
|
||||
|
||||
补丁清单文件是上图中以PackageManifest开头命名的文件。
|
||||
|
||||
- PackageManifest_DefaultPackage_xxxxxx.hash
|
||||
|
||||
记录了补丁清单文件的哈希值。
|
||||
|
||||
- PackageManifest_DefaultPackage_xxxxxx.json
|
||||
|
||||
该文件为Json文本格式，主要用于开发者预览信息。
|
||||
|
||||
- PackageManifest_DefaultPackage_xxxxxx.bytes
|
||||
|
||||
该文件为二进制格式，主要用于程序内读取加载。
|
||||
|
||||
### Jenkins支持
|
||||
|
||||
如果需要自动化构建，可以参考如下代码范例：
|
||||
|
||||
使用内置构建管线来构建资源包。
|
||||
|
||||
````c#
|
||||
private static void BuildInternal(BuildTarget buildTarget)
|
||||
{
|
||||
Debug.Log($"开始构建 : {buildTarget}");
|
||||
|
||||
// 构建参数
|
||||
string defaultOutputRoot = AssetBundleBuilderHelper.GetDefaultOutputRoot();
|
||||
BuildParameters buildParameters = new BuildParameters();
|
||||
buildParameters.OutputRoot = defaultOutputRoot;
|
||||
buildParameters.BuildTarget = buildTarget;
|
||||
buildParameters.BuildPipeline = EBuildPipeline.BuiltinBuildPipeline;
|
||||
buildParameters.BuildMode = EBuildMode.ForceRebuild;
|
||||
buildParameters.PackageName = "DefaultPackage";
|
||||
buildParameters.PackageVersion = "1.0";
|
||||
buildParameters.VerifyBuildingResult = true;
|
||||
buildParameters.CompressOption = ECompressOption.LZ4;
|
||||
buildParameters.OutputNameStyle = EOutputNameStyle.HashName;
|
||||
buildParameters.CopyBuildinFileOption = ECopyBuildinFileOption.None;
|
||||
|
||||
// 执行构建
|
||||
AssetBundleBuilder builder = new AssetBundleBuilder();
|
||||
var buildResult = builder.Run(buildParameters);
|
||||
if (buildResult.Success)
|
||||
{
|
||||
Debug.Log($"构建成功 : {buildResult.OutputPackageDirectory}");
|
||||
}
|
||||
else
|
||||
{
|
||||
Debug.LogError($"构建失败 : {buildResult.FailedInfo}");
|
||||
}
|
||||
}
|
||||
|
||||
// 从构建命令里获取参数示例
|
||||
private static string GetBuildPackageName()
|
||||
{
|
||||
foreach (string arg in System.Environment.GetCommandLineArgs())
|
||||
{
|
||||
if (arg.StartsWith("buildPackage"))
|
||||
return arg.Split("="[0])[1];
|
||||
}
|
||||
return string.Empty;
|
||||
}
|
||||
````
|
||||
|
||||
### 重要概念
|
||||
|
||||
- **增量构建**
|
||||
|
||||
增量构建是在Unity的帮助下实现的一种快速打包机制。主要是利用资源构建相关的缓存文件来避免二次构建，以此来提高打包效率。
|
||||
|
||||
- **强制构建**
|
||||
|
||||
强制构建是每次构建之前，都会清空之前构建的所有缓存文件，以此来重新构建资源包。
|
||||
|
||||
- **首包资源**
|
||||
|
||||
在构建应用程序的时候，我们希望将某些资源打进首包里，首包资源拷贝至StreamingAssets/BuildinFiles/目录下。首包资源如果发生变化，也可以通过热更新来更新资源。
|
||||
|
||||
- **补丁包**
|
||||
|
||||
无论是通过增量构建还是强制构建，在构建完成后都会生成一个以包裹版本（PackageVersion）命名的文件夹，我们把这个文件夹统称为补丁包。补丁包里包含了游戏运行需要的所有资源，我们可以无脑的将补丁包内容覆盖到CDN目录下，也可以通过编写差异分析工具，来筛选出和线上最新版本之间的差异文件，然后将差异文件上传到CDN目录里。
|
||||
|
|
@ -1,164 +0,0 @@
|
|||
# 资源收集
|
||||
|
||||
|
||||
|
||||
左侧为分组列表，右侧为该分组的配置界面。
|
||||
|
||||
导入按钮：可以导入保存的XML文件。
|
||||
|
||||
导出按钮：可以将配置数据导出为XML文件。
|
||||
|
||||
修复按钮：在配置里的文件夹挪动位置之后，可以通过该按钮按钮来修正。
|
||||
|
||||
**注意**：该工具仅支持Unity2019.4+
|
||||
|
||||
#### 公共设置
|
||||
|
||||
- Show Packages
|
||||
|
||||
是否展示资源包列表视图。
|
||||
|
||||
- Show Editor Alias
|
||||
|
||||
是否显示为中文模式。
|
||||
|
||||
- Enable Addressable
|
||||
|
||||
启用可寻址资源定位系统。
|
||||
|
||||
- Unique Bundle Name
|
||||
|
||||
资源包名追加PackageName作为前缀。
|
||||
|
||||
#### 资源分组
|
||||
|
||||
- Active Rule
|
||||
|
||||
激活规则，规则可以自定义扩展。下面是内置规则：
|
||||
|
||||
- EnableGroup 启用分组。
|
||||
|
||||
- DisableGroup 禁用分组。
|
||||
|
||||
````c#
|
||||
//自定义扩展范例
|
||||
public class DisableGroup : IActiveRule
|
||||
{
|
||||
public bool IsActiveGroup()
|
||||
{
|
||||
return false;
|
||||
}
|
||||
}
|
||||
````
|
||||
|
||||
- Grouper Name
|
||||
|
||||
分组名称
|
||||
|
||||
- Grouper Desc
|
||||
|
||||
分组备注信息
|
||||
|
||||
- Asset Tags
|
||||
|
||||
资源分类标签列表，该分组下收集的资源会全部被打上该标签。
|
||||
|
||||
注意：多个标签用分号隔开，例如 level1;level2;level3
|
||||
|
||||
#### 资源搜集器
|
||||
|
||||
- **Collect Path**
|
||||
|
||||
收集路径，可以指定文件夹或单个资源文件。
|
||||
|
||||
- **Collector Type**
|
||||
|
||||
收集器类型：
|
||||
|
||||
- MainAssetCollector 收集参与打包的主资源对象，并写入到资源清单的资源列表里（可以通过代码加载）。
|
||||
- StaticAssetCollector 收集参与打包的主资源对象，但不写入到资源清单的资源列表里（无法通过代码加载）。
|
||||
- DependAssetCollector 收集参与打包的依赖资源对象，但不写入到资源清单的资源列表里（无法通过代码加载）（当依赖资源没有被任何主资源引用的时候，则会在打包的时候自动剔除）。
|
||||
|
||||
StaticAssetCollector收集器和DependAssetCollector收集器适合对资源进行定制化打包策略。
|
||||
|
||||
示例1：一个游戏的粒子特效的纹理会非常多，通常特效制作师会把这些纹理放到一个文件夹内管理。如果我们把这些纹理打进一个AssetBundle文件内，当下次更新的时候，如果新增或改动了一个纹理，那么就要上传整个纹理的AssetBundle文件。我们可以把特效纹理通过DependAssetCollector收集器进行收集并自定义打包规则，通过文件名称的首字母进行小粒度打包，这样一个AssetBundle文件会被拆分为26个AssetBundle文件。
|
||||
|
||||
示例2：当我们需要严格控制某个文件夹内的依赖资源打进同一个AssetBundle文件内，那么StaticAssetCollector收集器是最佳选择，该收集器收集的资源，无论是否被其它资源引用或被多个资源引用，这些资源都会按照设定的打包规则打包，且这些资源不会被处理为share资源包。
|
||||
|
||||
- **AddressRule**
|
||||
|
||||
可寻址规则，规则可以自定义扩展。下面是内置规则：
|
||||
|
||||
- AddressByFileName 以文件名为定位地址。
|
||||
- AddressByFilePath 以文件路径为定位地址。
|
||||
- AddressByGrouperAndFileName 以分组名+文件名为定位地址。
|
||||
- AddressByFolderAndFileName 以文件夹名+文件名为定位地址。
|
||||
|
||||
````c#
|
||||
//自定义扩展范例
|
||||
public class AddressByFileName : IAddressRule
|
||||
{
|
||||
string IAddressRule.GetAssetAddress(AddressRuleData data)
|
||||
{
|
||||
return Path.GetFileNameWithoutExtension(data.AssetPath);
|
||||
}
|
||||
}
|
||||
````
|
||||
|
||||
- **PackRule**
|
||||
|
||||
打包规则，规则可以自定义扩展。下面是内置规则：
|
||||
|
||||
- PackSeparately 以文件路径作为资源包名，每个资源文件单独打包。
|
||||
- PackDirectory 以文件所在的文件夹路径作为资源包名，该文件夹下所有文件打进一个资源包。
|
||||
- PackTopDirectory 以收集器下顶级文件夹为资源包名，该文件夹下所有文件打进一个资源包。
|
||||
- PackCollector 以收集器路径作为资源包名，收集的所有文件打进一个资源包。
|
||||
- PackGroup 以分组名称作为资源包名，收集的所有文件打进一个资源包。
|
||||
- PackRawFile 目录下的资源文件会被处理为原生资源包。
|
||||
|
||||
````c#
|
||||
//自定义扩展范例
|
||||
public class PackDirectory : IPackRule
|
||||
{
|
||||
PackRuleResult IPackRule.GetBundleName(PackRuleData data)
|
||||
{
|
||||
//"Assets/Config/test.txt" --> "Assets/Config"
|
||||
string bundleName = Path.GetDirectoryName(data.AssetPath);
|
||||
PackRuleResult result = new PackRuleResult(bundleName, DefaultPackRule.AssetBundleFileExtension);
|
||||
return result;
|
||||
}
|
||||
bool IPackRule.IsRawFilePackRule()
|
||||
{
|
||||
return false;
|
||||
}
|
||||
}
|
||||
````
|
||||
|
||||
- **FilterRule**
|
||||
|
||||
过滤规则，规则可以自定义扩展。下面是内置规则：
|
||||
|
||||
- CollectAll 收集目录下的所有资源文件
|
||||
- CollectScene 只收集目录下的场景文件
|
||||
- CollectPrefab 只收集目录下的预制体文件
|
||||
- CollectSprite 只收集目录下的精灵类型的文件
|
||||
|
||||
````c#
|
||||
//自定义扩展范例
|
||||
public class CollectScene : IFilterRule
|
||||
{
|
||||
public bool IsCollectAsset(FilterRuleData data)
|
||||
{
|
||||
return Path.GetExtension(data.AssetPath) == ".unity";
|
||||
}
|
||||
}
|
||||
````
|
||||
|
||||
- **UserData**
|
||||
|
||||
用户自定义数据，可以帮助定制化AddressRule和PackRule。
|
||||
|
||||
- **AssetTags**
|
||||
|
||||
资源分类标签列表，该收集器下收集的资源会全部被打上该标签。
|
||||
|
||||
|
|
@ -1,20 +0,0 @@
|
|||
# 调试器
|
||||
|
||||
调试器是在游戏运行时，帮助我们查看资源包加载信息的工具，通过该工具可以发现潜在的资源泄漏。
|
||||
|
||||
可以查看资源对象列表信息（AssetView），资源包列表信息（BundleView）。
|
||||
|
||||
**注意**：该工具仅支持Unity2019.4+
|
||||
|
||||
### 真机远程调试注意事项
|
||||
|
||||
在构建安装包的时候，需要勾选上Development Build和Autoconnect Profiler
|
||||
|
||||
### 资源对象列表视图
|
||||
|
||||
|
||||
|
||||
### 资源包列表视图
|
||||
|
||||
|
||||
|
||||
|
|
@ -1,43 +0,0 @@
|
|||
# 资源部署
|
||||
|
||||
在资源补丁包构建成功之后，需要将补丁包传输到CDN服务器上。
|
||||
|
||||
如果是本地测试，可以在本地创建一个WEB服务器，然后将补丁包拷贝到WEB服务器下。
|
||||
|
||||
**部署目录**
|
||||
|
||||
在业务开发过程中，发版本之前都会创建一个SVN或GIT分支，以分支工程为基础去构建APP。
|
||||
|
||||
````
|
||||
CDN
|
||||
└─android
|
||||
├─v1.0（APP版本）
|
||||
├─v1.1（APP版本）
|
||||
└─v2.0（APP版本）
|
||||
└─iphone
|
||||
├─v1.0（APP版本）
|
||||
├─v1.1（APP版本）
|
||||
└─v2.0（APP版本）
|
||||
````
|
||||
|
||||
**APP版本说明**
|
||||
|
||||
v1.0 代表的是APP版本，不是资源版本。在没有更换安装包的情况下，不需要新增加APP版本目录。
|
||||
|
||||
例如：我们游戏的当前APP版本是v1.0，那么每次生成的补丁文件全部覆盖到v1.0的目录下即可。
|
||||
|
||||
下面的示例里一共上传过2次补丁包。第二次上传的补丁包会把第一次的版本记录文件（PackageManifest_DefaultPackage.version）覆盖掉。当我们想回退资源版本的时候，把第一次生成的版本记录文件覆盖到同目录下即可。
|
||||
|
||||
````
|
||||
v1.0（游戏版本）
|
||||
├─PackageManifest_DefaultPackage.version
|
||||
├─PackageManifest_DefaultPackage_2023-02-01-654.hash
|
||||
├─PackageManifest_DefaultPackage_2023-02-01-654.bytes
|
||||
├─PackageManifest_DefaultPackage_2023-02-12-789.hash
|
||||
├─PackageManifest_DefaultPackage_2023-02-12-789.bytes
|
||||
├─2bb5a28d37dabf27df8bc6a4706b8f80.bundle
|
||||
├─2dbea9c3056c8839bc03d80a2aebd105.bundle
|
||||
├─6e8c3003a64ead36a0bd2d5cdebfbcf4.bundle
|
||||
...
|
||||
````
|
||||
|
||||
|
|
@ -1,21 +0,0 @@
|
|||
# 构建报告
|
||||
|
||||
报告工具，可以查看概览信息（Summary），资源对象列表信息（AssetView），资源包列表信息（BundleView）。
|
||||
|
||||
**注意**：该工具仅支持Unity2019.4+
|
||||
|
||||
### 概览视图
|
||||
|
||||
|
||||
|
||||
### 资源对象列表视图
|
||||
|
||||
可以查看资源对象列表以及每个资源对象所依赖的资源包。
|
||||
|
||||
|
||||
|
||||
### 资源包列表视图
|
||||
|
||||
可以查看资源包列表以及每个资源包所包含的资源对象。
|
||||
|
||||
|
||||
|
|
@ -1,147 +0,0 @@
|
|||
# 代码贡献
|
||||
|
||||
代码贡献请遵循下面的规范。
|
||||
|
||||
### 提交规范
|
||||
|
||||
每个PR只针对一项内容的改进或修复，请勿合并提交。
|
||||
|
||||
PR标题尽量选择英文，备注内容可选中文。
|
||||
|
||||
### 对齐规范
|
||||
|
||||
Tab键对齐（可以在VS里设置）
|
||||
|
||||
### 命名规范
|
||||
|
||||
[规则1-1] 英文单词命名。禁止使用拼音或无意义的字母命名。
|
||||
|
||||
[规则1-2] 直观易懂。使用能够描述其功能或有意义的英文单词或词组。
|
||||
|
||||
[规则1-3] 不要采用下划线命名法。
|
||||
|
||||
```C#
|
||||
int car_type //错误：下划线命名。
|
||||
```
|
||||
|
||||
[规则1-4] 常量、静态字段、类、结构体、非私有字段、方法等名称采用**大驼峰式命名法**
|
||||
|
||||
```C#
|
||||
public const float MaxSpeed = 100f; //常量
|
||||
public static float MaxSpeed = 100f; //静态字段
|
||||
public class GameClass; //类
|
||||
public struct GameStruct; //结构体
|
||||
public string FirstName; //public字段
|
||||
protected string FirstName; //protected字段
|
||||
public void SendMessage(string message) {} //方法
|
||||
```
|
||||
|
||||
[规则1-5] 私有字段、方法形参、局部变量采用 **小驼峰式命名法**
|
||||
|
||||
注意：私有字段以下划线开头
|
||||
|
||||
```C#
|
||||
private string _firstName; //私有字段
|
||||
public void FindByFirstName(string firstName) {} //方法参数
|
||||
string firstName; //局部变量
|
||||
```
|
||||
|
||||
[规则1-6] 接口命名
|
||||
|
||||
注意：接口以大写字母I开头
|
||||
|
||||
```C#
|
||||
public interface IState; //接口
|
||||
```
|
||||
|
||||
[规则1-7] 枚举命名
|
||||
|
||||
注意：枚举以大写字母E开头
|
||||
|
||||
```C#
|
||||
public enum EGameType {Simple, Hard}//枚举及枚举值
|
||||
```
|
||||
|
||||
### 编码规范
|
||||
|
||||
[规则2-1] 声明变量时，一行只声明一个变量。
|
||||
|
||||
```C#
|
||||
private string _firstName;
|
||||
private string _lastName;
|
||||
```
|
||||
|
||||
[规则2-2] 类的字段声明统一放置于类的最前端。
|
||||
|
||||
```C#
|
||||
public class Student
|
||||
{
|
||||
private string _firstName;
|
||||
private string _lastName;
|
||||
|
||||
public string GetFirstName()
|
||||
{
|
||||
return _firstFiled;
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
[规则2-3] 一行代码长度不要超过屏幕宽度。如果超过了，将超过部分换行。
|
||||
|
||||
### 注释规范
|
||||
|
||||
[规则3-1] 公共方法注释，采用 /// 形式自动产生XML标签格式的注释。包括方法介绍，参数含义，返回内容。
|
||||
|
||||
注意：私有方法可以不用注释。
|
||||
|
||||
```C#
|
||||
/// <summary>
|
||||
/// 设置场景名称
|
||||
/// </summary>
|
||||
/// <param name="sceneName">场景名</param>
|
||||
/// <returns>如果设置成功返回True</returns>
|
||||
public bool SetSceneName(string sceneName)
|
||||
{
|
||||
}
|
||||
```
|
||||
|
||||
[规则3-2] 公共字段注释，采用 /// 形式自动产生XML标签格式的注释。
|
||||
|
||||
注意：私有字段可以不用注释。
|
||||
|
||||
```C#
|
||||
public class SceneManager
|
||||
{
|
||||
/// <summary>
|
||||
/// 场景的名字
|
||||
/// </summary>
|
||||
public string SceneName;
|
||||
}
|
||||
```
|
||||
|
||||
[规则3-3] 私有字段注释，注释位于代码后面，中间Space键隔开。
|
||||
|
||||
```C#
|
||||
public class Student
|
||||
{
|
||||
private string _firstName; //姓氏
|
||||
private string _lastName; //姓名
|
||||
}
|
||||
```
|
||||
|
||||
[规则3-4] 方法内的代码块注释。
|
||||
|
||||
```C#
|
||||
public void UpdateHost
|
||||
{
|
||||
// 和服务器通信
|
||||
...
|
||||
|
||||
// 检测通信结果
|
||||
...
|
||||
|
||||
// 分析数据
|
||||
...
|
||||
}
|
||||
```
|
||||
|
||||
|
|
@ -1,103 +0,0 @@
|
|||
# 初始化
|
||||
|
||||
初始化资源系统
|
||||
|
||||
```c#
|
||||
// 初始化资源系统
|
||||
YooAssets.Initialize();
|
||||
|
||||
// 创建默认的资源包
|
||||
var package = YooAssets.CreatePackage("DefaultPackage");
|
||||
|
||||
// 设置该资源包为默认的资源包，可以使用YooAssets相关加载接口加载该资源包内容。
|
||||
YooAssets.SetDefaultPackage(package);
|
||||
```
|
||||
|
||||
资源系统的运行模式支持三种：编辑器模拟模式，单机运行模式，联机运行模式。
|
||||
|
||||
**编辑器模拟模式**
|
||||
|
||||
在编辑器下，不需要构建资源包，来模拟运行游戏。
|
||||
|
||||
注意：该模式只在编辑器下起效
|
||||
|
||||
````c#
|
||||
private IEnumerator InitializeYooAsset()
|
||||
{
|
||||
var initParameters = new EditorSimulateModeParameters();
|
||||
initParameters.SimulatePatchManifestPath = EditorSimulateModeHelper.SimulateBuild("DefaultPackage");
|
||||
yield return package.InitializeAsync(initParameters);
|
||||
}
|
||||
````
|
||||
|
||||
**单机运行模式**
|
||||
|
||||
对于不需要热更新资源的游戏，可以使用单机运行模式。
|
||||
|
||||
注意：该模式需要构建资源包
|
||||
|
||||
````c#
|
||||
private IEnumerator InitializeYooAsset()
|
||||
{
|
||||
var initParameters = new OfflinePlayModeParameters();
|
||||
yield return package.InitializeAsync(initParameters);
|
||||
}
|
||||
````
|
||||
|
||||
**联机运行模式**
|
||||
|
||||
对于需要热更新资源的游戏，可以使用联机运行模式，该模式下初始化参数会很多。
|
||||
|
||||
注意：该模式需要构建资源包
|
||||
|
||||
- DecryptionServices : 如果资源包在构建的时候有加密，需要提供实现IDecryptionServices接口的实例类。
|
||||
|
||||
- QueryServices：内置资源查询服务接口。
|
||||
|
||||
- DefaultHostServer : 默认的资源服务器IP地址。
|
||||
|
||||
- FallbackHostServer : 备用的资源服务器IP地址。
|
||||
|
||||
````c#
|
||||
private IEnumerator InitializeYooAsset()
|
||||
{
|
||||
var initParameters = new HostPlayModeParameters();
|
||||
initParameters.QueryServices = new QueryStreamingAssetsFileServices();
|
||||
initParameters.DefaultHostServer = "http://127.0.0.1/CDN1/Android/v1.0";
|
||||
initParameters.FallbackHostServer = "http://127.0.0.1/CDN2/Android/v1.0";
|
||||
yield return package.InitializeAsync(initParameters);
|
||||
}
|
||||
|
||||
// 内置文件查询服务类
|
||||
private class QueryStreamingAssetsFileServices : IQueryServices
|
||||
{
|
||||
public bool QueryStreamingAssets(string fileName)
|
||||
{
|
||||
// StreamingAssetsHelper.cs是太空战机里提供的一个查询脚本。
|
||||
string buildinFolderName = YooAssets.GetStreamingAssetBuildinFolderName();
|
||||
return StreamingAssetsHelper.FileExists($"{buildinFolderName}/{fileName}");
|
||||
}
|
||||
}
|
||||
````
|
||||
|
||||
### 源代码解析
|
||||
|
||||
Package.InitializeAsync()方法解析。
|
||||
|
||||
- 编辑器模拟模式
|
||||
|
||||
每次启动调用EditorSimulateModeHelper.SimulateBuild()方法，都会在底层执行一次模拟构建（Simulate Build）。
|
||||
|
||||
如果参与构建的资源对象数量级很大的话则会有卡顿现象，可以通过直接指定已有的清单路径来避免每次都重复执行模拟构建。
|
||||
|
||||
- 单机运行模式
|
||||
|
||||
在初始化的时候，会直接读取内置清单文件（StreamingAssets文件夹里的文件），最后初始化缓存系统。
|
||||
|
||||
- 联机运行模式
|
||||
|
||||
在初始化的时候，会优先从沙盒里加载清单，如果沙盒里不存在，则会尝试加载内置清单并将其拷贝到沙盒里。最后初始化缓存系统。
|
||||
|
||||
**注意**：如果沙盒清单和内置清单都不存在，初始化也会被判定为成功！
|
||||
|
||||
|
||||
|
|
@ -1,167 +0,0 @@
|
|||
# 资源更新
|
||||
|
||||
**获取资源版本**
|
||||
|
||||
对于联机运行模式，在更新补丁清单之前，需要获取一个资源版本。
|
||||
|
||||
该资源版本可以通过YooAssets提供的接口来更新，也可以通过HTTP访问游戏服务器来获取。
|
||||
|
||||
````c#
|
||||
private IEnumerator UpdatePackageVersion()
|
||||
{
|
||||
var package = YooAssets.GetPackage("DefaultPackage");
|
||||
var operation = package.UpdatePackageVersionAsync();
|
||||
yield return operation;
|
||||
|
||||
if (operation.Status == EOperationStatus.Succeed)
|
||||
{
|
||||
//更新成功
|
||||
string packageVersion = operation.PackageVersion;
|
||||
Debug.Log($"Updated package Version : {packageVersion}");
|
||||
}
|
||||
else
|
||||
{
|
||||
//更新失败
|
||||
Debug.LogError(operation.Error);
|
||||
}
|
||||
}
|
||||
````
|
||||
|
||||
**更新补丁清单**
|
||||
|
||||
对于联机运行模式，在获取到资源版本号之后，就可以更新资源清单了。
|
||||
|
||||
````c#
|
||||
private IEnumerator UpdatePackageManifest()
|
||||
{
|
||||
var package = YooAssets.GetPackage("DefaultPackage");
|
||||
var operation = package.UpdatePackageManifestAsync(packageVersion);
|
||||
yield return operation;
|
||||
|
||||
if (operation.Status == EOperationStatus.Succeed)
|
||||
{
|
||||
//更新成功
|
||||
}
|
||||
else
|
||||
{
|
||||
//更新失败
|
||||
Debug.LogError(operation.Error);
|
||||
}
|
||||
}
|
||||
````
|
||||
|
||||
**补丁包下载**
|
||||
|
||||
在补丁清单更新完毕后，就可以更新资源文件了。
|
||||
|
||||
根据产品需求，可以选择更新全部资源，或者只更新部分资源。
|
||||
|
||||
补丁包下载接口：
|
||||
|
||||
- YooAssets.CreateResourceDownloader(int downloadingMaxNumber, int failedTryAgain, int timeout)
|
||||
|
||||
用于下载更新当前资源版本所有的资源包文件。
|
||||
|
||||
- YooAssets.CreateResourceDownloader(string[] tags, int downloadingMaxNumber, int failedTryAgain, int timeout)
|
||||
|
||||
用于下载更新资源标签指定的资源包文件。
|
||||
|
||||
- YooAssets.CreateBundleDownloader(AssetInfo[] assetInfos, int downloadingMaxNumber, int failedTryAgain, int timeout)
|
||||
|
||||
用于下载更新指定的资源列表依赖的资源包文件。
|
||||
|
||||
````c#
|
||||
IEnumerator Download()
|
||||
{
|
||||
int downloadingMaxNum = 10;
|
||||
int failedTryAgain = 3;
|
||||
int timeout = 60;
|
||||
var package = YooAssets.GetPackage("DefaultPackage");
|
||||
var downloader = package.CreateResourceDownloader(downloadingMaxNum, failedTryAgain, timeout);
|
||||
|
||||
//没有需要下载的资源
|
||||
if (downloader.TotalDownloadCount == 0)
|
||||
{
|
||||
yield break;
|
||||
}
|
||||
|
||||
//需要下载的文件总数和总大小
|
||||
int totalDownloadCount = downloader.TotalDownloadCount;
|
||||
long totalDownloadBytes = downloader.TotalDownloadBytes;
|
||||
|
||||
//注册回调方法
|
||||
downloader.OnDownloadErrorCallback = OnDownloadErrorFunction;
|
||||
downloader.OnDownloadProgressCallback = OnDownloadProgressUpdateFunction;
|
||||
downloader.OnDownloadOverCallback = OnDownloadOverFunction;
|
||||
downloader.OnStartDownloadFileCallback = OnStartDownloadFileFunction;
|
||||
|
||||
//开启下载
|
||||
downloader.BeginDownload();
|
||||
yield return downloader;
|
||||
|
||||
//检测下载结果
|
||||
if (downloader.Status == EOperationStatus.Succeed)
|
||||
{
|
||||
//下载成功
|
||||
}
|
||||
else
|
||||
{
|
||||
//下载失败
|
||||
}
|
||||
}
|
||||
````
|
||||
|
||||
**弱联网环境解决方案**
|
||||
|
||||
对于偏单机但是也有资源热更需求的项目。当玩家在无网络的时候，我们又不希望玩家卡在资源更新步骤而不能正常游戏。所以当玩家本地网络有问题的时候，我们可以跳过资源更新的步骤。
|
||||
|
||||
````c#
|
||||
private IEnumerator Start()
|
||||
{
|
||||
var package = YooAssets.GetPackage("DefaultPackage");
|
||||
var operation = package.UpdatePackageVersionAsync(30);
|
||||
yield return operation;
|
||||
if (operation.Status == EOperationStatus.Succeed)
|
||||
{
|
||||
// 如果获取远端资源版本成功，说明当前网络连接通畅，可以走正常更新流程。
|
||||
......
|
||||
}
|
||||
else
|
||||
{
|
||||
// 如果获取远端资源版本失败，说明当前网络无连接。
|
||||
// 在正常开始游戏之前，需要验证本地清单内容的完整性。
|
||||
string packageVersion = package.GetPackageVersion();
|
||||
var operation = package.PreDownloadContentAsync(packageVersion);
|
||||
yield return operation;
|
||||
if (operation.Status != EOperationStatus.Succeed)
|
||||
{
|
||||
ShowMessageBox("请检查本地网络，有新的游戏内容需要更新！");
|
||||
yield break;
|
||||
}
|
||||
|
||||
int downloadingMaxNum = 10;
|
||||
int failedTryAgain = 3;
|
||||
int timeout = 60;
|
||||
var downloader = operation.CreateResourceDownloader(downloadingMaxNum, failedTryAgain, timeout);
|
||||
if (downloader.TotalDownloadCount > 0)
|
||||
{
|
||||
// 资源内容本地并不完整，需要提示玩家联网更新。
|
||||
ShowMessageBox("请检查本地网络，有新的游戏内容需要更新！");
|
||||
yield break;
|
||||
}
|
||||
|
||||
// 开始游戏
|
||||
StartGame();
|
||||
}
|
||||
}
|
||||
````
|
||||
|
||||
### 源代码解析
|
||||
|
||||
Package.UpdatePackageManifestAsync()方法解析。
|
||||
|
||||
- 联机运行模式
|
||||
|
||||
通过传入的清单版本，优先比对当前激活清单的版本，如果相同就直接返回成功。如果有差异就从缓存里去查找匹配的清单，如果缓存里不存在，就去远端下载并保存到沙盒里。最后加载沙盒内匹配的清单文件。
|
||||
|
||||
|
||||
|
|
@ -1,174 +0,0 @@
|
|||
# 资源加载
|
||||
|
||||
**加载方法**
|
||||
|
||||
- LoadSceneAsync() 异步加载场景
|
||||
- LoadAssetSync() 同步加载资源对象
|
||||
- LoadAssetAsync() 异步加载资源对象
|
||||
- LoadSubAssetsSync() 同步加载子资源对象
|
||||
- LoadSubAssetsAsync() 异步加载子资源对象
|
||||
- LoadRawFileSync() 同步获取原生文件
|
||||
- LoadRawFileAsync() 异步获取原生文件
|
||||
|
||||
**统一约定**
|
||||
|
||||
**Location**为资源的定位地址，也是加载资源对象的唯一标识符。
|
||||
|
||||
- 在未开启可寻址模式下，location代表的是资源对象的完整路径。
|
||||
|
||||
```c#
|
||||
// 以工程内的音频文件为例："Assets/GameRes/Audio/bgMusic.mp3"
|
||||
package.LoadAssetAsync<AudioClip>("Assets/GameRes/Audio/bgMusic");
|
||||
```
|
||||
|
||||
- 在开启可寻址模式下，location代表的是资源对象可寻址地址。
|
||||
|
||||
````c#
|
||||
// 以工程内的音频文件为例："Assets/GameRes/Audio/bgMusic.mp3"
|
||||
// 需要在资源配置界面启用可寻址功能（Enable Addressable）。
|
||||
// 配置界面的可寻址规则为AddressByFileName，那么资源定位地址填写文件名称："bgMusic"
|
||||
package.LoadAssetAsync<AudioClip>("bgMusic");
|
||||
````
|
||||
|
||||
**加载路径的匹配方式**
|
||||
|
||||
````C#
|
||||
// 不带扩展名的模糊匹配
|
||||
package.LoadAssetAsync<AudioClip>("Assets/GameRes/Audio/bgMusic");
|
||||
|
||||
// 带扩展名的精准匹配
|
||||
package.LoadAssetAsync<AudioClip>("Assets/GameRes/Audio/bgMusic.mp3");
|
||||
````
|
||||
|
||||
**异步加载范例**
|
||||
|
||||
````C#
|
||||
// 委托加载方式
|
||||
void Start()
|
||||
{
|
||||
AssetOperationHandle handle = package.LoadAssetAsync<AudioClip>("Assets/GameRes/Audio/bgMusic.mp3");
|
||||
handle.Completed += Handle_Completed;
|
||||
}
|
||||
void Handle_Completed(AssetOperationHandle handle)
|
||||
{
|
||||
AudioClip audioClip = handle.AssetObject as AudioClip;
|
||||
}
|
||||
````
|
||||
````C#
|
||||
// 协程加载方式
|
||||
IEnumerator Start()
|
||||
{
|
||||
AssetOperationHandle handle = package.LoadAssetAsync<AudioClip>("Assets/GameRes/Audio/bgMusic.mp3");
|
||||
yield return handle;
|
||||
AudioClip audioClip = handle.AssetObject as AudioClip;
|
||||
}
|
||||
````
|
||||
````C#
|
||||
// Task加载方式
|
||||
async void Start()
|
||||
{
|
||||
AssetOperationHandle handle = package.LoadAssetAsync<AudioClip>("Assets/GameRes/Audio/bgMusic.mp3");
|
||||
await handle.Task;
|
||||
AudioClip audioClip = handle.AssetObject as AudioClip;
|
||||
}
|
||||
````
|
||||
|
||||
**资源卸载范例**
|
||||
|
||||
````C#
|
||||
IEnumerator Start()
|
||||
{
|
||||
AssetOperationHandle handle = package.LoadAssetAsync<AudioClip>("Assets/GameRes/Audio/bgMusic.mp3");
|
||||
yield return handle;
|
||||
...
|
||||
handle.Release();
|
||||
}
|
||||
````
|
||||
|
||||
**资源释放范例**
|
||||
|
||||
可以在切换场景之后调用资源释放方法或者写定时器间隔时间去释放。
|
||||
|
||||
注意：只有调用资源释放方法，资源对象才会在内存里被移除。
|
||||
|
||||
````c#
|
||||
private void UnloadAssets()
|
||||
{
|
||||
var package = YooAssets.GetAssetsPackage("DefaultPackage");
|
||||
package.UnloadUnusedAssets();
|
||||
}
|
||||
````
|
||||
|
||||
**预制体加载范例**
|
||||
|
||||
````C#
|
||||
IEnumerator Start()
|
||||
{
|
||||
AssetOperationHandle handle = package.LoadAssetAsync<GameObject>("Assets/GameRes/Panel/login.prefab");
|
||||
yield return handle;
|
||||
GameObject go = handle.InstantiateSync();
|
||||
Debug.Log($"Prefab name is {go.name}");
|
||||
}
|
||||
````
|
||||
|
||||
**子对象加载范例**
|
||||
|
||||
例如：通过TexturePacker创建的图集，如果需要访问图集的精灵对象，可以通过子对象加载接口。
|
||||
|
||||
````c#
|
||||
IEnumerator Start()
|
||||
{
|
||||
SubAssetsOperationHandle handle = package.LoadSubAssetsAsync<Sprite>(location);
|
||||
yield return handle;
|
||||
var sprite = handle.GetSubAssetObject<Sprite>("spriteName");
|
||||
Debug.Log($"Sprite name is {sprite.name}");
|
||||
}
|
||||
````
|
||||
|
||||
**场景异步加载范例**
|
||||
|
||||
注意：当加载新的主场景的时候，会自动释放之前加载的主场景以及附加场景。
|
||||
|
||||
````c#
|
||||
IEnumerator Start()
|
||||
{
|
||||
string location = "Assets/GameRes/Scene/Login";
|
||||
var sceneMode = UnityEngine.SceneManagement.LoadSceneMode.Single;
|
||||
bool activateOnLoad = true;
|
||||
SceneOperationHandle handle = package.LoadSceneAsync(location, sceneMode, activateOnLoad);
|
||||
yield return handle;
|
||||
Debug.Log($"Scene name is {handle.Scene.name}");
|
||||
}
|
||||
````
|
||||
|
||||
**原生文件加载范例**
|
||||
|
||||
例如：wwise的初始化文件
|
||||
|
||||
````c#
|
||||
IEnumerator Start()
|
||||
{
|
||||
string location = "Assets/GameRes/wwise/init.bnk";
|
||||
RawFileOperationHandle handle = package.LoadRawFileAsync(location);
|
||||
yield return handle;
|
||||
byte[] fileData = handle.GetRawFileData();
|
||||
string fileText = handle.GetRawFileText();
|
||||
string filePath = handle.GetRawFilePath();
|
||||
}
|
||||
````
|
||||
|
||||
**获取资源信息列表**
|
||||
|
||||
通过资源标签来获取资源信息列表。
|
||||
|
||||
````c#
|
||||
void GetAssetInfosByTag(string tag)
|
||||
{
|
||||
AssetInfo[] assetInfos = package.GetAssetInfos(tag);
|
||||
foreach (var assetInfo in assetInfos)
|
||||
{
|
||||
Debug.Log(assetInfo.AssetPath);
|
||||
}
|
||||
}
|
||||
````
|
||||
|
||||
|
|
@ -1,80 +0,0 @@
|
|||
# 解决方案
|
||||
|
||||
### FairyGUI支持解决方案
|
||||
|
||||
注意：在FairyGUI的面板销毁的时候，将资源句柄列表释放，否则会造成资源泄漏。
|
||||
|
||||
````c#
|
||||
// 资源句柄列表
|
||||
private List<AssetOperationHandle> _handles = new List<AssetOperationHandle>(100);
|
||||
|
||||
// 加载方法
|
||||
private object LoadFunc(string name, string extension, System.Type type, out DestroyMethod method)
|
||||
{
|
||||
method = DestroyMethod.None; //注意：这里一定要设置为None
|
||||
string location = $"Assets/FairyRes/{name}{extension}";
|
||||
var package = YooAssets.GetPackage("DefaultPackage");
|
||||
var handle = package.LoadAssetSync(location , type);
|
||||
_handles.Add(handle);
|
||||
return handle.AssetObject;
|
||||
}
|
||||
|
||||
// 执行FairyGUI的添加包函数
|
||||
UIPackage.AddPackage(name, LoadFunc);
|
||||
|
||||
// 释放资源句柄列表
|
||||
private void ReleaseHandles()
|
||||
{
|
||||
foreach(var handle in _handles)
|
||||
{
|
||||
handle.Release();
|
||||
}
|
||||
_handles.Clear();
|
||||
}
|
||||
````
|
||||
|
||||
### UniTask支持解决方案
|
||||
|
||||
详情参考 [UniTask 配置教程](../Assets/YooAsset/Samples~/UniTask%20Sample/README.md)
|
||||
|
||||
### 分布式构建解决方案
|
||||
|
||||
**1.3.0+版本升级指南**
|
||||
|
||||
在升级之前请导出AssetBundleCollector的配置为XML文件，然后升级YooAssets库。
|
||||
|
||||
首次需要打开AssetBundleCollector窗口，然后导入之前保存的XML文件。
|
||||
|
||||
在运行游戏之前，请保证资源包可以构建成功！
|
||||
|
||||
```c#
|
||||
IEnumerator Start()
|
||||
{
|
||||
// 初始化YooAssets资源系统（必须代码）
|
||||
YooAssets.Initialize();
|
||||
|
||||
// 创建资源包实例
|
||||
var package = YooAssets.CreatePackage("DefaultPackage");
|
||||
|
||||
// 初始化资源包
|
||||
......
|
||||
yield return package.InitializeAsync(createParameters);
|
||||
|
||||
// 更新资源包版本
|
||||
......
|
||||
var operation = package.UpdatePackageManifestAsync(packageCRC);
|
||||
yield return operation;
|
||||
|
||||
// 下载更新文件
|
||||
var downloader = package.CreatePatchDownloader(downloadingMaxNum, failedTryAgain);
|
||||
downloader.BeginDownload();
|
||||
yield return downloader;
|
||||
|
||||
// 加载资源对象
|
||||
var assetHandle = package.LoadAssetAsync("Assets/GameRes/npc.prefab");
|
||||
yield return assetHandle;
|
||||
......
|
||||
}
|
||||
|
||||
```
|
||||
|
||||
|
|
@ -1,12 +0,0 @@
|
|||
# 感谢所有支持YooAsset的小伙伴们！
|
||||
|
||||
**特别感谢以下QQ社区的小伙伴**
|
||||
|
||||
他们帮忙协助解决了很多BUG以及提出了很多宝贵的意见！
|
||||
|
||||
- 黄色幻想 (793301844)
|
||||
- 新乞丐王子 (82470934)
|
||||
- Wales-丁 (709501148)
|
||||
- L (401419353)
|
||||
- 秀 (1025466218)
|
||||
- martin (643087149)
|
||||
101
Docs/FAQ.md
101
Docs/FAQ.md
|
|
@ -1,101 +0,0 @@
|
|||
# 常见问题解答
|
||||
|
||||
#### 问题：在编辑器下，用离线模式或联机模式运行游戏，为什么游戏里的模型会变成紫色？
|
||||
|
||||
如果在打AssetBundle的时候，选定的构建目标是安卓。那么在windows操作系统下，编辑器的默认渲染模式为DX11，我们需要修改编辑器的渲染模式，可以通过UnityHub来修改启动项目的编辑器渲染模式，[参考官方文档](https://docs.unity3d.com/cn/2019.4/Manual/CommandLineArguments.html)。
|
||||
|
||||
在Vulkan下打包的编辑器需要加个command -force-vulkan
|
||||
|
||||
windows平台添加命令: **-force-gles**
|
||||
|
||||
#### 问题：Unity2021编辑器运行游戏提示YooAssets is initialized !
|
||||
|
||||
尝试关闭：Project Setting ---> Editor ---> Enter Play Mode Options
|
||||
|
||||
#### 问题：YooAsset的DLL引用丢失导致编译报错了
|
||||
|
||||
1. 请在PlayerSetting里修改API Level为.NET 4.x或者.NET Framework
|
||||
2. 关闭游戏工程后，删除Assets同级目录下所有的csproj文件和sln文件。
|
||||
3. 删除Library/ScriptAssemblies文件夹。
|
||||
4. 重新打开游戏工程，然后点击某个脚本重新编译。
|
||||
|
||||
#### 问题：UnityEditor.Build.Pipeline引用丢失问题
|
||||
|
||||
YooAsset依赖于ScriptBuildPipeline（SBP），在PackageManager里找到SBP插件安装就可以了。
|
||||
|
||||
#### 问题：使用FileZilla等FTP上传工具后，文件下载总是验证失败
|
||||
|
||||
把传输类型修改为二进制就可以了。
|
||||
|
||||
#### 问题：打包的时候报错：Cannot mark assets and scenes in one AssetBundle. AssetBundle name is "assets_xxxx_scenes.bundle
|
||||
|
||||
Unity引擎不允许把场景文件和其它资源文件一起打包。
|
||||
|
||||
#### 问题：WebGL平台运行时报错：Failed to decompress data for the AssetBundle.
|
||||
|
||||
WebGL平台不支持资源文件加密。在构建选项里，可以将加密方法设置为空
|
||||
|
||||
#### 问题：有个别手机每次启动执行YooAsset初始化，都执行了有8秒钟，其它手机倒是没事。
|
||||
|
||||
检查下手机沙盒内容是否存储在SD卡里。
|
||||
|
||||
#### 问题：ClearCacheWhenDirty参数没了吗？
|
||||
|
||||
不是很必须的一个功能，已经移除了。可以使用以下方法代替：
|
||||
|
||||
````c#
|
||||
// 参考DEMO的代码
|
||||
internal class FsmClearCache : IFsmNode
|
||||
{
|
||||
void IFsmNode.OnEnter()
|
||||
{
|
||||
Debug.Log("清理未使用的缓存文件！");
|
||||
var package = YooAssets.GetPackage("DefaultPackage");
|
||||
var operation = package.ClearUnusedCacheFiles();
|
||||
operation.Completed += Operation_Completed;
|
||||
}
|
||||
|
||||
private void Operation_Completed(YooAsset.AsyncOperationBase obj)
|
||||
{
|
||||
Debug.Log("开始游戏！");
|
||||
......
|
||||
}
|
||||
}
|
||||
````
|
||||
|
||||
#### 问题：YooAsset支持Unity2018吗
|
||||
|
||||
YooAsset分俩部分，编辑器代码和运行时代码。因为工具界面是使用UIElements编写的，所以在Unity2019以前的版本是使用不了界面化工具。但是这并没有影响我们使用YooAsset，以下提供一种解决方案。
|
||||
|
||||
请先通过Package Manager安装Scriptable Build Pipeline插件。
|
||||
|
||||
1. 资源包收集工具替代方案
|
||||
|
||||
````C#
|
||||
// 推荐直接手动编辑资源收集配置文件，在Sample工程里可以找到AssetBundleCollectorConfig.xml的文件，我们直接拿过来做模板。
|
||||
// 然后通过以下代码来导入配置文件，成功之后AssetBundleCollectorSetting.asset文件会被刷新，就可以运行游戏了。
|
||||
// 注意：每次修改完XML文件，都需要导入配置文件。
|
||||
AssetBundleCollectorConfig.ImportXmlConfig("C://Demo//Assets//AssetBundleCollectorConfig.xml");
|
||||
````
|
||||
|
||||
2. 资源包构建工具替代方案
|
||||
|
||||
````c#
|
||||
// 资源包构建可以直接参考教程文档，在文档的最下面有Jenkins支持介绍。
|
||||
````
|
||||
|
||||
资源构建教程：https://github.com/tuyoogame/YooAsset/blob/main/Docs/AssetBundleBuilder.md
|
||||
|
||||
3. 资源包报告工具替代方案
|
||||
|
||||
````c#
|
||||
// 我们可以使用Unity2019或更高版本来创建一个包含YooAsset的工程查看构建报告。
|
||||
````
|
||||
|
||||
4. 资源包调试工具替代方案
|
||||
|
||||
````c#
|
||||
// YooAsset支持真机远程调试，我们可以使用Unity2019或更高版本来创建一个包含YooAsset的工程调试。
|
||||
// 如果想在编辑器下调试，可以仿照编写一个调试界面。
|
||||
````
|
||||
|
||||
|
|
@ -1,12 +0,0 @@
|
|||
# 全局配置
|
||||
|
||||
|
||||
|
||||
通过右键创建配置文件（Project窗体内右键 -> Create -> YooAsset -> Create Setting）
|
||||
|
||||
**注意**：请将配置文件放在Resources文件夹下
|
||||
|
||||
配置说明：
|
||||
|
||||
- **Manifest File Name** : 补丁清单文件名称
|
||||
|
||||
Binary file not shown.
|
Before Width: | Height: | Size: 60 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 89 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 166 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 88 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 81 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 107 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 161 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 168 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 35 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 67 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 64 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 73 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 14 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 44 KiB |
|
|
@ -1,66 +0,0 @@
|
|||
# 快速开始
|
||||
|
||||
#### **下载安装**
|
||||
|
||||
1. **通过PackageManager安装**
|
||||
|
||||
打开管理界面 **Edit/Project Settings/Package Manager**
|
||||
|
||||
````
|
||||
// 输入以下内容
|
||||
Name: package.openupm.cn
|
||||
URL: https://package.openupm.cn
|
||||
Scope(s): com.tuyoogame.yooasset
|
||||
````
|
||||
|
||||
|
||||
|
||||
打开管理界面 **Edit/Windows/Package Manager**
|
||||
|
||||
|
||||
|
||||
2. **通过Packages清单安装**
|
||||
|
||||
直接修改Packages文件夹下的清单文件manifest.json
|
||||
|
||||
````json
|
||||
{
|
||||
"dependencies": {
|
||||
"com.tuyoogame.yooasset": "0.0.1-preview",
|
||||
......
|
||||
},
|
||||
"scopedRegistries": [
|
||||
{
|
||||
"name": "package.openupm.cn",
|
||||
"url": "https://package.openupm.cn",
|
||||
"scopes": [
|
||||
"com.tuyoogame.yooasset"
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
````
|
||||
|
||||
3. **通过Github下载安装**
|
||||
|
||||
在发布的Release版本中，选择最新版本下载Source Code压缩包。
|
||||
|
||||
#### **系统需求**
|
||||
|
||||
支持版本: Unity2019.4+
|
||||
|
||||
支持平台: Windows、OSX、Android、iOS
|
||||
|
||||
开发环境: .NET4.x
|
||||
|
||||
#### **目录结构**
|
||||
|
||||
````
|
||||
Assets
|
||||
└─ YooAsset
|
||||
├─ Editor 编辑器源码目录
|
||||
├─ Runtime 运行时源码目录
|
||||
├─ LICENSE 版权文档
|
||||
└─ README 说明文档
|
||||
````
|
||||
|
||||
|
|
@ -1,21 +0,0 @@
|
|||
# 示例教程
|
||||
|
||||
|
||||
|
||||
#### 示例内容
|
||||
|
||||
**Space Shooter** 太空战机DEMO，包含资源热更和加载的示例。
|
||||
|
||||
**Extension Sample** 包含编辑器扩展代码的示例。
|
||||
|
||||
**UniTask Sample** 包含支持UniTask代码的示例。
|
||||
|
||||
#### 导入流程注意事项
|
||||
|
||||
|
||||
|
||||
1. Space Shooter在导入完成后，打开YooAsset->AssetBundle Collector窗口。
|
||||
1. 点击修复按钮，然后点击Save按钮保存配置，最后关闭窗口。
|
||||
3. 找到Boot.scene场景启动游戏。
|
||||
|
||||
|
||||
|
|
@ -1,39 +0,0 @@
|
|||
# 着色器变种收集
|
||||
|
||||
|
||||
|
||||
点击搜集变种按钮开始收集，请耐心等待结束。
|
||||
|
||||
**注意：在收集完成之后，需要将生成的shadervariants文件配置到收集界面（AssetBundle Collector）。**
|
||||
|
||||
### Jenkins支持
|
||||
|
||||
```c#
|
||||
public static void CollectSVC()
|
||||
{
|
||||
string savePath = ShaderVariantCollectorSettingData.Setting.SavePath;
|
||||
System.Action completedCallback = () =>
|
||||
{
|
||||
ShaderVariantCollection collection =
|
||||
AssetDatabase.LoadAssetAtPath<ShaderVariantCollection>(savePath);
|
||||
if (collection != null)
|
||||
{
|
||||
Debug.Log($"ShaderCount : {collection.shaderCount}");
|
||||
Debug.Log($"VariantCount : {collection.variantCount}");
|
||||
}
|
||||
else
|
||||
{
|
||||
throw new Exception("Failed to Collect shader Variants.");
|
||||
}
|
||||
|
||||
EditorTools.CloseUnityGameWindow();
|
||||
EditorApplication.Exit(0);
|
||||
};
|
||||
ShaderVariantCollector.Run(savePath, completedCallback);
|
||||
}
|
||||
```
|
||||
|
||||
```c#
|
||||
// 命令行调用
|
||||
%Projects_UnityEngine_Path% -batchmode -projectPath %Projects_UnityProject_Path% -executeMethod ET.CIHelper.CollectSVC -logFile %Projects_UnityProject_Path%/Logs/CIBuildSVC.log
|
||||
```
|
||||
43
README.md
43
README.md
|
|
@ -8,7 +8,7 @@
|
|||
|
||||
它可以满足商业化游戏的各类需求，并且经历多款百万DAU游戏产品的验证。
|
||||
|
||||
## 介绍
|
||||
### 介绍
|
||||
|
||||
YooAsset可以满足以下任何需求：
|
||||
|
||||
|
|
@ -19,7 +19,7 @@ YooAsset可以满足以下任何需求：
|
|||
- 我想发布一个MOD游戏安装包，玩家可以把自己制作的MOD内容上传到服务器，其它玩家可以下载游玩。
|
||||
- 我们在制作一个超大体量的项目，有上百GB的资源内容，每次构建都花费大量时间，是否可以分工程构建？
|
||||
|
||||
## 系统特点
|
||||
### 系统特点
|
||||
|
||||
- **构建管线无缝切换**
|
||||
|
||||
|
|
@ -65,42 +65,7 @@ YooAsset可以满足以下任何需求：
|
|||
|
||||
支持线上版本快速回退，支持区分审核版本，测试版本，线上版本，支持灰度更新及测试。
|
||||
|
||||
## 入门教程
|
||||
1. [快速开始](./Docs/QuickStart.md)
|
||||
2. [全局配置](./Docs/GlobalSettings.md)
|
||||
3. [资源配置](./Docs/AssetBundleCollector.md)
|
||||
4. [资源打包](./Docs/AssetBundleBuilder.md)
|
||||
5. [资源部署](./Docs/AssetBundleDeployer.md)
|
||||
5. [构建报告](./Docs/AssetBundleReporter.md)
|
||||
5. [调试器](./Docs/AssetBundleDebugger.md)
|
||||
5. [着色器](./Docs/ShaderVariantCollector.md)
|
||||
5. [FAQ](./Docs/FAQ.md)
|
||||
### 官方主页（教程文档）
|
||||
|
||||
## 代码教程
|
||||
1. [初始化](./Docs/CodeTutorial1.md)
|
||||
2. [资源更新](./Docs/CodeTutorial2.md)
|
||||
3. [资源加载](./Docs/CodeTutorial3.md)
|
||||
3. [解决方案](./Docs/CodeTutorial4.md)
|
||||
https://www.yooasset.com/
|
||||
|
||||
## 其它教程
|
||||
|
||||
[视频教程](https://space.bilibili.com/328590743/channel/seriesdetail?sid=2207858)
|
||||
|
||||
[示例教程](./Docs/Samples.md)
|
||||
|
||||
## 社区
|
||||
|
||||
QQ群：**963240451**
|
||||
|
||||
[致谢名单](./Docs/Contributor.md)👯
|
||||
|
||||
[代码贡献](./Docs/CodeStyle.md)
|
||||
|
||||
## 友情链接
|
||||
[ET Framework](https://github.com/wqaetly/ET/tree/et7_fgui_yooasset_luban_huatuo): ET 7.0 + FGUI + luban + huatuo + YooAsset + NKGMoba + UniTask，并提供常用的编辑器工具。
|
||||
|
||||
[ETPro](https://github.com/526077247/ETPro) ET6+YooAsset+HybridCLR
|
||||
|
||||
[YooAssetEx](https://gitee.com/liu_zhongxiu/yoo-asset-ex/tree/master): YooAsset Odin扩展工具，用于支持Unity2017和Unity2018版本。
|
||||
|
||||
[GameFramework-at-YooAsset](https://github.com/ALEXTANGXIAO/GameFramework-at-YooAsset) GameFramework +luban + hybridclr + YooAsset + UniTask
|
||||
|
|
|
|||
Loading…
Reference in New Issue