AI对话记录: 2026-03-10

This commit is contained in:
2026-03-11 08:00:08 +08:00
parent 1498a01693
commit a8d4891ed9
19 changed files with 2391 additions and 160 deletions
@@ -0,0 +1,141 @@
# 变量初始化顺序需要与定义顺序一致。
```
//修改前
FAnimNode_CustomLookAt::FAnimNode_CustomLookAt()
: LookAtLocation(FVector(100.f, 0.f, 0.f))
, LookAt_Axis(DefaultLookAtAxis)
, IsFirstLookAtNode(true)
, IsAddLookAtRotator(true)
, LookAtUpClamp(90.f)
, LookAtDownClamp(90.f)
, LookAtHClamp(90.f)
, LookAtWeight(1)
#if WITH_EDITORONLY_DATA
, LookAtAxis_DEPRECATED(EAxisOption::Y)
, CustomLookAtAxis_DEPRECATED(FVector(0.f, 1.f, 0.f))
, LookUpAxis_DEPRECATED(EAxisOption::X)
, CustomLookUpAxis_DEPRECATED(FVector(1.f, 0.f, 0.f))
#endif
, CurrentLookAtLocation(ForceInitToZero)
, CachedCurrentTargetLocation(ForceInitToZero)
,LookAtFollowFrameSpeed(1.f)
,CachedDeltaRotation(FRotator(.0f,.0f,.0f))
,FollowParentLimitHAngle(0.f)
,FollowParentLimitVAngle(0.f)
```
```
//修改后
FAnimNode_CustomLookAt::FAnimNode_CustomLookAt()
: LookAtLocation(FVector(100.f, 0.f, 0.f))
, LookAt_Axis(DefaultLookAtAxis)
, IsFirstLookAtNode(true)
, IsAddLookAtRotator(true)
, LookAtUpClamp(90.f)
, LookAtDownClamp(90.f)
, LookAtWeight(1)
, LookAtHClamp(90.f)
#if WITH_EDITORONLY_DATA
, LookAtAxis_DEPRECATED(EAxisOption::Y)
, CustomLookAtAxis_DEPRECATED(FVector(0.f, 1.f, 0.f))
, LookUpAxis_DEPRECATED(EAxisOption::X)
, CustomLookUpAxis_DEPRECATED(FVector(1.f, 0.f, 0.f))
#endif
, CurrentLookAtLocation(ForceInitToZero)
, CachedCurrentTargetLocation(ForceInitToZero)
,CachedDeltaRotation(FRotator(.0f,.0f,.0f))
,LookAtFollowFrameSpeed(1.f)
,FollowParentLimitHAngle(0.f)
,FollowParentLimitVAngle(0.f)
```
# 宽字符集用TEXT()而不是用L
```
//修改前
FString SliceType = L"不切分";
```
```
//修改后
FString SliceType = TEXT("不切分");
```
# 部分旧版接口在Mac已经弃用
```
class CRIWARERUNTIME_API FManaTextureResource : public FTextureResource, public FRenderTarget
/* FRenderResource 仮想関数をオーバーライド */virtual void InitRHI(FRHICommandListBase& RHICmdList) override;
virtual void ReleaseRHI() override;
```
```
class FAppleManaTextureSampler : public FManaTextureResource
{
public:
FAppleManaTextureSampler(FCriWareManaApple& InManaApple, const UManaTexture* InOwner);
virtual void InitDynamicRHI() override;
virtual void ReleaseDynamicRHI() override;
```
# C++数组不能直接比较
```
//修改前
#define UNUSED(arg) { if ((arg) == (arg)) {} }
```
```
//修改后
#define UNUSED(arg) { if (sizeof(arg) == sizeof(arg)) {} }
```
# 注释内的注释
/**/ 里面如果还想用/*注释时,*/会导致提前结束注释。因此改成了#1#替代。但是Mac上不允许。用//替代内部的/*
# TCHAR_TO_UTF8
TCHAR_TO_UTF8 是一个虚幻引擎宏,用于将TCHAR转换为UTF-8字符,这个宏会创建一个临时对象来进行转换,临时对象在完整表达式结束的时候就会被销毁。代码将这个临时对象的内部指针地址复制给AwbPath。这样当这个临时对象被销毁之后,AwbPath就变成了悬空指针,指向已经无效的内存。
改法:用FTCHARToUTF8定义变量然后赋值出去,不再用宏。
```
//修改前
const CriChar8 * AwbPath = TCHAR_TO_UTF8(*AwbName);
/* クック時はAWBファイルをバインドしない */if(GIsCookerLoadingPackage) {
AwbPath = NULL;
}
// ACBファイルのロード */if (Params.ResourceData) {
// uasset内にACBデータが保持されている場合はメモリからロード
Handle = criAtomExAcb_LoadAcbData(
reinterpret_cast<void*>(Params.ResourceData), static_cast<CriSint32>(Params.ResourceDataSize), Params.Binder, AwbPath, nullptr, 0);
} else {
// uasset内にACBデータが保持されていない場合はファイルからロード(旧バージョンのデータが該当)
Handle = criAtomExAcb_LoadAcbFile(nullptr, TCHAR_TO_UTF8(*AcbName), Params.Binder, AwbPath, nullptr, 0);
}
```
```
//修改后
FTCHARToUTF8 AwbNameUtf8(*AwbName);
const CriChar8 * AwbPath = AwbNameUtf8.Get();
/* クック時はAWBファイルをバインドしない */if(GIsCookerLoadingPackage) {
AwbPath = NULL;
}
// ACBファイルのロード */if (Params.ResourceData) {
// uasset内にACBデータが保持されている場合はメモリからロード
Handle = criAtomExAcb_LoadAcbData(
reinterpret_cast<void*>(Params.ResourceData), static_cast<CriSint32>(Params.ResourceDataSize), Params.Binder, AwbPath, nullptr, 0);
} else {
// uasset内にACBデータが保持されていない場合はファイルからロード(旧バージョンのデータが該当)
Handle = criAtomExAcb_LoadAcbFile(nullptr, AwbNameUtf8.Get(), Params.Binder, AwbPath, nullptr, 0);
}
```
# typeid RTTI(运行时类型信息)被虚幻禁用
虚幻引擎有自己的UObject体系。不需要用typeid
```
//修改前
template <typename T>
bool FEditorAnomalyOptionBase::CanCast()
{
FString ClassName = GetMatchName();
FString MatchName = typeid(T).name();
return ClassName.Equals(MatchName);
}
```
```
//修改后
```
@@ -1,88 +0,0 @@
# 参考文档
https://www.bilibili.com/opus/946339882709549060
https://dev.epicgames.com/documentation/zh-cn/unreal-engine/setting-up-an-unreal-engine-project-for-ios
# 环境准备
## 官方推荐环境
对于UE5.6,官方推荐:
- macOS Sonoma 14.7
- XCode 16.1
最低:
- macOS Sonoma 14.5
- XCode 16
我们的macOS是14.6,XCode是15.4。XCode需要升级
## 注册开发者账号
从手机AppStore下载AppleDeveloper,填写信息注册开发账号并支付年费开通
## 开发者证书(Certificates)/应用ID(Identifiers)/设备(Devices)/描述文件(Profiles)
https://blog.csdn.net/niubitianping/article/details/113137555
### 证书
每个开发者账号有一套
证书分两种,开发证书和发布证书,每种证书包含两个文件。
.cer,本机XCode打包使用。包含公钥
.p12 多人开发时其他人使用,或者用跨平台开发工具打包时使用(可能既包含公钥也包含私钥)
先创建证书请求:
1. 启动台->其他->钥匙串访问,打开钥匙串访问界面
2. 菜单->钥匙串访问->证书助理->从证书颁发机构请求证书
3. 填写电子邮箱地址(Apple账号电子邮箱),常用名称(可以叫 公司名称 Dev Key),选择保存到磁盘
创建证书:
4. 打开证书管理网页
5. 点集创建证书
6. 上传证书请求
7. 将生成的证书保存到本地。
#### ID
每个应用一个
在标识符页面上创建com.mq.proj1
#### Device
每个设备一个
在设备页面上添加设备,设备名称自定义,设备UUID可以用以下方法获取:
1. 打开XCode
2. 链接Iphone
3. 从XCode菜单->窗口->设备和模拟器
4. 在设备页签找到刚刚连接的设备,选中。
5. 在右侧详情查看标识符,复制到网页
#### 描述文件
用来描述证书/ID/Device之间的关系。
选择证书,ID,和设备,生成一个描述并下载到本地。
## 升级XCode
1. 访问
[https://developer.apple.com/download/all/](https://developer.apple.com/download/all/)
2. 用 Apple ID 登录
3. 搜索 "Xcode 16"
4. 下载 .xip 文件(约 8-10GB)
5. 放到合适的位置,双击运行,最好删掉之前旧的,以免一些原因误操作打开。
# 获取代码
- clone 源码仓库
- 执行setup.command
- 这一步要下载很多依赖,可能要等比较久,翻墙会稍微快一点,遇到长时间0速度时可以关掉再执行,会断点续传。
- 执行GenerateProjectFiles.command,生成XCode工程
- 打开UE5(Mac).xcworkspace
- 顶条上搜索选择ShaderCompileWorker,目标平台My Mac,菜单Product->Build 进行编译
- 顶条上选择UnrealEditor,目标平台My Mac,菜单Product->Build 进行编译
# 设置XCode
打开XCode->Settings。选择标签页Locations,找到选项CommandLineTools,选择正确的XCode(本地可能会有多个不同路径不同版本的)
# 创建游戏项目
打开UE,等待Shader编译完成,选择创建游戏项目,选择C++项目,平台Mobile,质量Scalable
# 编译游戏项目工程
在游戏项目目录,找到(Mac).xcworkspace,打开
顶部平台切换成"项目名称Editor"。Run,编译应该很快,只有十几个
Run成功之后打开项目工程的UE窗口
去编辑->项目设置->平台->iOS中设置BundleID和包名,即前面AppleDeveloper账号拿到的BundleID。
去编辑->项目设置->平台->Xcode项目中设置
- 勾选现代化XCode
- 填写 Apple开发账户团队ID (TeamID不是账号名称是后面那一串10位的字符串)
- 填写数据包ID
- 勾选使用自动代码签名
关闭编辑器
# 打包项目
1. **在Xcode** >**偏好设置**>**帐户**中将您的 Apple Developer ID 与 Xcode 连接。
2. 打开(IOS).xcworkspace,选择工程,属性页面切换到Signing & Capablities,自动管理签名,选择团队,输入bundleid。
3. 属性界面回到General页签,填入包名和 Bundle Identifier 名称 com.mq.proj1。
4. 连上iphone手机,编译游戏项目的XCode(第一次编译需要下载对应IOS版本的 Simulator)。
5.
6.
@@ -0,0 +1,266 @@
---
tags: [UE5, iOS, 打包, macOS, Xcode, Apple开发者, 源码引擎]
---
# 虚幻引擎 5.6 iOS 平台源码引擎打包指南
## 参考文档
- [UE官方文档:现代化XCode流程](https://dev.epicgames.com/documentation/zh-cn/unreal-engine/using-modern-xcode-in-unreal-engine)
- [UE官方文档:iOS打包快速流程](https://dev.epicgames.com/documentation/zh-cn/unreal-engine/setting-up-an-unreal-engine-project-for-ios)
- [B站:操作全流程演示](https://www.bilibili.com/opus/946339882709549060)
- [CSDN:Apple开发者五件套的获取](https://blog.csdn.net/niubitianping/article/details/113137555)
- [苹果开发者官网](https://developer.apple.com)
---
## 一、环境准备
### 1.1 官方推荐环境
| 组件 | 推荐版本 | 最低版本 |
|------|----------|----------|
| macOS | Sonoma 14.7 | Sonoma 14.5 |
| Xcode | 16.1 | 16 |
> ⚠️ **重要**:必须使用正确的 Xcode 版本。当前环境为 macOS 14.6 + Xcode 16。
### 1.2 升级 Xcode
1. 访问 [Apple 开发者下载页](https://developer.apple.com/download/all/)
2. 使用 Apple ID 登录
3. 搜索 "Xcode 16"
4. 下载 `.xip` 文件(约 8-10GB)
5. 双击解压,建议先删除旧版本避免混淆
### 1.3 注册开发者账号
1. 用iphone手机从 App Store 下载 **Apple Developer** 应用(需要摄像头拍照)
2. 按指引填写信息并支付年费($99/年)
---
## 二、Apple 开发者配置(五件套)
![Apple开发者五件套](https://mice-cola.oss-cn-beijing.aliyuncs.com/20260310121453.png)
### 2.1 证书(Certificates)
每个开发者账号需要分别配置开发环境和发布环境的证书。
**证书文件说明:**
| 文件类型 | 用途 |
|----------|------|
| `.certSigningRequest` | 证书请求文件 |
| `.cer` | 证书文件,本机 Xcode 打包使用 |
| `.p12` | 证书副本,多机协作时使用 |
#### 步骤一:创建证书请求
1. 打开 **钥匙串访问**(启动台 → 其他 → 钥匙串访问)
2. 菜单栏:**钥匙串访问 → 证书助理 → 从证书颁发机构请求证书**
3. 填写信息:
- 电子邮箱:Apple 账号邮箱
- 常用名称:如 `Mq Dev Key`
- 选择:**保存到磁盘**
4. 保存文件
> 💡 此操作不仅保存了证书请求,还在钥匙串中生成了一对公私钥,名称即上面填写的常用名称,后续打包时会用到。
![证书请求](https://mice-cola.oss-cn-beijing.aliyuncs.com/20260310121324.png)
#### 步骤二:创建开发证书
1. 访问 [Apple 证书管理页面](https://developer.apple.com/account/resources/certificates/list)
2. 点击创建证书,选择 **Apple Development**
3. 上传刚才保存的证书请求文件
4. 下载生成的 `.cer` 证书文件
5. 双击证书,添加到钥匙串
> ⚠️ **注意**:每种类型的证书只能有一个。如果之前已创建,选项会显示灰色。
![证书类型选择](https://mice-cola.oss-cn-beijing.aliyuncs.com/20260310121223.png)
![钥匙串中的证书](https://mice-cola.oss-cn-beijing.aliyuncs.com/20260310152548.png)
#### 步骤三:导出 p12 文件(可选)
选中钥匙串中刚添加的证书,菜单 → 文件 → 导出项目。
> ⚠️ **待确认**:导出 p12 选项显示灰色,需要进一步排查。
### 2.2 应用 ID(Identifiers)
每个应用需要一个唯一的 Bundle ID。
在标识符页面创建,如:`com.mq.proj1`
### 2.3 设备(Devices)
注册用于开发测试的 iOS 设备。
**获取设备 UUID:**
1. 打开 Xcode
2. 连接 iPhone
3. 菜单:**窗口 → 设备和模拟器**
4. 选中设备,复制标识符
![设备标识符](https://mice-cola.oss-cn-beijing.aliyuncs.com/20260310121750.png)
### 2.4 描述文件(Profiles)
描述文件定义了**开发者证书 + 应用 Bundle ID + 设备**之间的关系,即"谁在哪个设备上开发/发布哪个应用"。
配置步骤:
1. 选择开发证书
2. 选择应用 ID
3. 选择所有需要调试的设备
4. 生成并下载 `.mobileprovision` 文件
### 2.5 WWDR 证书
> 📝 待补充
---
## 三、获取引擎源代码
```bash
# 1. 克隆仓库
git clone http://gitlab.mq.com/engine/engine1.git
# 2. 下载依赖(耗时较长,需要翻墙)
./Setup.command
# 3. 生成 Xcode 工程
./GenerateProjectFiles.command
```
**编译引擎:**
1. 打开 `UE5(Mac).xcworkspace`
2. 编译 ShaderCompileWorker:
- 顶部选择 `ShaderCompileWorker`,目标 `My Mac`
- Product → Build
3. 编译 UnrealEditor:
- 顶部选择 `UnrealEditor`,目标 `My Mac`
- Product → Build
> ⚠️ **注意**:Mac 编译要求严格,如类成员定义顺序必须与构造函数初始化顺序一致。建议先在 Windows 环境清理编译警告。
---
## 四、配置 Xcode
1. **设置命令行工具**
- Xcode → Settings → Locations
- Command Line Tools 选择正确的 Xcode 版本
2. **关联开发者账号**
- Xcode → 设置 → 账户
- 添加 Apple Developer ID
---
## 五、创建游戏项目
1. 启动 UE 编辑器,等待 Shader 编译完成
2. 创建新项目:
- 模板:C++ 项目
- 平台:Mobile
- 质量:Scalable
---
## 六、编译游戏项目
1. 打开项目目录下的 `(项目名)(Mac).xcworkspace`
2. 顶部目标选择 `(项目名)Editor`
3. 点击 Run 编译(编译很快,约十几个文件)
4. 成功后会自动打开 UE 编辑器
---
## 七、从编辑器打包
### 7.1 项目设置
**iOS 平台设置**(编辑 → 项目设置 → 平台 → iOS):
- `Bundle DisplayName`:应用显示名称
- `Bundle Name`:如 `proj1`(与 Apple Developer 中的 Bundle ID 对应)
**Xcode 设置**(编辑 → 项目设置 → 平台 → Xcode):
- ✅ 勾选 **现代化 Xcode**
- 填写 **Apple 开发账户团队 ID**(Team ID,10位字符串,非账号名称)
- 填写 **数据包 ID**
- ✅ 勾选 **使用自动代码签名**
**打包设置**(编辑 → 项目设置 → 打包):
- 设置为 **Shipping** 包
### 7.2 执行打包
编辑器工具栏 → 平台 → iOS → 打包项目
**注意事项:**
1. 编译、Cook、打包三个阶段会弹出签名请求,需要输入本机密码
2. 官方第三人称示例可能缺少材质:`/Engine/EngineDebugMaterials/M_SimpleUnlitTranslucent_TwoSides`
3. 使用编辑器打包时,无需手动修改生成的 `(iOS).xcworkspace`
---
## 八、安装到 iPhone
1. 打开 Xcode
2. 菜单:**Window → Devices and Simulators**
3. 连接 iPhone
4. 将打包生成的 `.app` 文件拖到 **Installed Apps** 区域
![安装应用](https://mice-cola.oss-cn-beijing.aliyuncs.com/20260310142633.png)
---
## 九、命令行打包
```bash
/Users/mooquan/engine/Engine/Build/BatchFiles/RunUAT.sh \
BuildCookRun \
-project=/Users/mooquan/work/game_test/IOSPackTest4/IOSPackTest4.uproject \
-noP4 \
-platform=iOS \
-clientconfig=Shipping \
-cook -build -stage -pak -archive \
-archivedirectory=/Users/mooquan/pack/IOSPackTest4/
```
---
## 十、打开 Windows 生成的工程
如果项目在 Windows 上创建,需要在 Mac 上生成 Xcode 工程:
```bash
/Users/mooquan/work/engine/GenerateProjectFiles.command \
-project="/Users/mooquan/work/game/client/client.uproject" \
-game -engine
```
然后打开 `client(Mac).xcworkspace`,目标选择 `clientEditor`。
---
## 十一、发布
> 📝 专门文档待补充
---
## 常见问题
### Q: 导出 p12 选项灰色?
待排查
### Q: 编译报类成员顺序错误?
Mac 编译器要求严格,确保类成员定义顺序与构造函数初始化列表一致。
### Q: 签名弹窗密码错误?
检查钥匙串中的私钥是否正确,尝试重新生成证书请求。
@@ -1,20 +1,60 @@
# UEPCG道路生成经验总结
## 道路模型生成与地形修改
UE5.6生成道路的几种方式
- LandscapeSplineActor沿曲线生成道路+MeshALandscape->UpdateLandscapeSplines 修改地形
- 关键点1:为整个曲线生成一个LandscapeSplineActor。为曲线上每一个采样点创建一个LandscapeSplineControlPoint,为每两个ControlPoint创建一个Segment。
- 关键点2:ControlPoint+Segement的bRaiseTerrain和bLowerTerrain设置为true
- 坑点:ControlPoint EndFallOff需要为0,否则每一段Segment会起波浪
- 不需要道路模型的,可以用 ALandscapeProxy->EditorApplySpline 在曲线层调整地形和调整地形材质。
- 坑点:用LandscapeSplineActor来生成Mesh时不能用,地形调整会被覆盖。
- LandscapeSplineActor + ULandscapeInfo->ApplySplines 来调整地形,理论上可行,因为关卡编辑器的地形编辑自己就是用这个方法去修正地形的,但是还没有跑通,我在关卡编辑器外部去调用时会崩溃。·
## 道边护栏
道边护栏是一种要求连续衔接的模型,在不同曲率的地方要对模型做弯折,USplineMeshComponent就是做这个用的,具体用法:
- 找一个轴向细分段数较多的模型作为基础模型。
- 将一整段曲线按一定长度分成多段(最好是按模型长度来,否则容易看出纹理拉伸,如果是重复纹理的模型,可以随意)
- 每一段生成一个SplineMeshComponent,设置Start,End和Tangent。
- 如何在中间随机一段不生成,或者生成坏的,待进一步研究。
- 电线杆+电线理论上也可以这么干
- 人行道也可以用这个方式,或者直接做在道路模型中。
## 路灯
路灯是一种按一定规律间隔出现的路边物体,不要求两两之间连续。可以用纯PCG逻辑生成。
# UE PCG 道路生成经验总结
## 一、道路模型生成与地形修改
在 UE5.6 中,道路生成主要有以下几种方式:
### 1. LandscapeSplineActor 沿曲线生成道路 + 修改地形
通过 `LandscapeSplineActor` 沿曲线生成道路 Mesh,并调用 `Landscape->UpdateLandscapeSplines()` 修改地形。
**实现要点:**
- 为整条曲线创建一个 `LandscapeSplineActor`
- 为曲线上的每个采样点创建一个 `LandscapeSplineControlPoint`
- 为每两个相邻的 `ControlPoint` 创建一个 `Segment`
**地形适配设置:**
- 将 `ControlPoint` 和 `Segment` 的 `bRaiseTerrain` 和 `bLowerTerrain` 均设为 `true`
**踩坑记录:**
> `ControlPoint` 的 `EndFallOff` 必须设为 0,否则每段 `Segment` 交界处会出现波浪状起伏。
### 2. 纯地形调整(无道路 Mesh)
如果不需要生成道路模型,仅需要调整地形和地形材质,可使用:
```
ALandscapeProxy->EditorApplySpline()
```
**踩坑记录:**
> 此方法与 `LandscapeSplineActor` 生成 Mesh 的方式互斥,地形调整会被后者覆盖。
### 3. LandscapeSplineActor + ApplySplines(待验证)
理论上可通过 `LandscapeSplineActor` 配合 `ULandscapeInfo->ApplySplines()` 来调整地形,关卡编辑器的地形编辑正是使用此方法。但在编辑器外部调用时存在崩溃问题,**尚未跑通**。
---
## 二、道边护栏
道边护栏要求连续衔接,且需根据曲率对模型进行弯折处理。`USplineMeshComponent` 正是为此设计。
### 实现方法
1. **选择基础模型**:选用轴向细分段数较多的模型,便于弯折变形
2. **曲线分段**:将整条曲线按一定长度切分
- 推荐按模型实际长度分段,避免纹理拉伸明显
- 若模型使用重复纹理,可灵活分段
3. **生成 SplineMesh**:为每段生成一个 `SplineMeshComponent`,设置 `Start`、`End` 位置及 `Tangent`
4. **随机中断效果**:如何在中间随机跳过某段或生成破损效果,**待进一步研究**
### 扩展应用
- 电线杆 + 电线的生成
- 人行道(或直接整合进道路模型中)
---
## 三、路灯
路灯属于按固定间隔出现在路边的物体,不要求连续衔接,可直接使用纯 PCG 逻辑生成。
@@ -0,0 +1,41 @@
# AI Agent的上下文
GSD如何搞定稳定的流程的。
1.上下文工程
2.XML提示词设计
3.子代理编排
4.状态管理
6.产出什么要规定好
5.验证很重要,需要循环到通过为止。
7.结束的明确指令
## GSD
目的
大的工作流程(你做什么,你做完之后给谁,他们是干什么的)
哲学
用户知道什么?
什么应该问用户?
什么不应该问用户?
边界
什么允许做(搞清楚模糊的定义)
什么不允许做(加新功能)
用一个问题来澄清这些事情属于哪一类
给出示例
当用户做了超出边界的事情时应该怎么回应?
灰色地带
具体步骤
# 技能的上下文
## Clawlist
- 技能用途
- 何时使用(When)
- 场景示例(What)
- 工作流(How)
- 头脑风暴
- 编写计划
- 执行任务
- 验证任务
- 快速参考(框架流程画图)
- 子技能
- 边界情况
- 关键命令
- 依赖