update UniTask sample
更新说明文档
This commit is contained in:
@@ -1,57 +1,52 @@
|
||||
# UniTask 扩展
|
||||
|
||||
这里为了照顾新手使用,做了一些妥协,有定制需求的需要手动调整一下
|
||||
|
||||
## 代码示例
|
||||
|
||||
```csharp
|
||||
public async UniTask Example(IProgress<float> progress = null, PlayerLoopTiming timing = PlayerLoopTiming.Update)
|
||||
using System;
|
||||
using UnityEngine;
|
||||
using YooAsset;
|
||||
using Cysharp.Threading.Tasks;
|
||||
|
||||
public class TestTask : MonoBehaviour
|
||||
{
|
||||
var handle = YooAssets.LoadAssetAsync<GameObject>("Assets/Res/Prefabs/TestImg.prefab");
|
||||
|
||||
await handle.ToUniTask(progress, timing);
|
||||
|
||||
var obj = handle.AssetObject as GameObject;
|
||||
var go = Instantiate(obj, transform);
|
||||
|
||||
go.transform.localPosition = Vector3.zero;
|
||||
go.transform.localScale = Vector3.one;
|
||||
private async void Start()
|
||||
{
|
||||
var assetHandle = YooAssets.LoadAssetAsync<GameObject>("UIHome");
|
||||
await assetHandle.ToUniTask();
|
||||
Debug.Log($"{assetHandle.Status}");
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## 初学者教程
|
||||
## 使用教程
|
||||
|
||||
**如果你弄不明白 asmdef 文件到底是啥,就按照下发内容操作**
|
||||
1. 下载 [UniTask](https://github.com/Cysharp/UniTask) 源码并导入到工程内。
|
||||
|
||||
- 将 `Samples/UniTask Sample/UniTask` 文件夹拷入游戏中
|
||||
- 如果项目有 `asmdef`,则引用 `UniTask` 和 `YooAsset`,如果没有,就不用关心这一步
|
||||
2. 修改UniTask源码
|
||||
|
||||
UniTask/Runtime/_InternalVisibleTo.cs
|
||||
|
||||
## 项目定制教程
|
||||
```csharp
|
||||
using System.Runtime.CompilerServices;
|
||||
|
||||
[assembly: InternalsVisibleTo("UniTask.Linq")]
|
||||
[assembly: InternalsVisibleTo("UniTask.Addressables")]
|
||||
[assembly: InternalsVisibleTo("UniTask.DOTween")]
|
||||
[assembly: InternalsVisibleTo("UniTask.TextMeshPro")]
|
||||
[assembly: InternalsVisibleTo("UniTask.YooAsset")] //增加此行代码
|
||||
```
|
||||
|
||||
- 请去下载 [UniTask](https://github.com/Cysharp/UniTask) 源码
|
||||
- 注意不要用 `Sample` 里面的 `UniTask` 这个是专门给新手定制的
|
||||
- 将 `Samples/UniTask Sample/UniTask/Runtime/External/YooAsset` 文件夹拷贝到 `UniTask/Runtime/External/YooAsset` 中
|
||||
- 创建 `UniTask.YooAsset.asmdef` 文件
|
||||
- 添加 `UniTask` 和 `YooAsset` 的引用
|
||||
- 在 UniTask `_InternalVisibleTo.cs` 文件中增加 `[assembly: InternalsVisibleTo("UniTask.YooAsset")]` 后即可使用
|
||||
3. 拷贝YOO提供的扩展脚本到工程内。
|
||||
|
||||
## 有效性检查
|
||||
YooAssets/Samples/UniTask Sample/UniTask/Runtime/External/YooAsset目录
|
||||
|
||||
一般使用项目定制时, 会出现如下警告, 这说明项目没有配置正确, 建议使用 **初学者定制的** 版本
|
||||
4. 重启Unity引擎
|
||||
|
||||
```
|
||||
yield BundledSceneProvider is not supported on await IEnumerator or Enumerator. ToUniTaskO, please use ToUniTask MonoBehaviou
|
||||
coroutine Runner) instead
|
||||
```
|
||||
重新打开工程后用上面的代码示例验证,看下是否有编译错误!
|
||||
|
||||
- 在 IDE 中点击 ToUniTask 跳转代码, 看是否可以正确跳转到 `UniTask/Runtime/External/YooAsset` 文件夹中
|
||||
- 增加 `handle.ToUniTask(progress, timing)` 参数, 看是否有编译错误
|
||||
## 注意事项
|
||||
|
||||
如果不正确, 需要检查业务逻辑的 `asmdef` 是否引用正确, 假设你项目业务逻辑的 `asmdef` 名为 `View.asmdef`, 那么在 `View` 中, 要包含如下引用
|
||||
- 注意检测程序集引用是否丢失
|
||||
|
||||
- YooAsset
|
||||
- UniTask
|
||||
- UniTask.YooAsset
|
||||
|
||||
如果引用正确, 依然还有报错, 说明定制流程有问题, 请检查定制内容是否正确, 或者使用 **初学者定制的** 版本
|
||||

|
||||
Reference in New Issue
Block a user