update UniTask sample

更新说明文档
This commit is contained in:
何冠峰
2025-07-24 14:45:52 +08:00
parent 956b3db71d
commit 2254ac9f5e
9 changed files with 276 additions and 191 deletions
@@ -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
如果引用正确, 依然还有报错, 说明定制流程有问题, 请检查定制内容是否正确, 或者使用 **初学者定制的** 版本
![image](./README-IMG.png)