فهرست منبع

Book:1.1 增加更多 VS 版本与 Rider 版本描述分支,以及部分编译、打包错误可能原因 (#294)

* Update 1.1运行指南.md
Oliver_Kane 4 سال پیش
والد
کامیت
12832c52b9
1فایلهای تغییر یافته به همراه33 افزوده شده و 17 حذف شده
  1. 33 17
      Book/1.1运行指南.md

+ 33 - 17
Book/1.1运行指南.md

@@ -1,38 +1,46 @@
 # 运行步骤  
 1. visual studio用户须知:
-   - VS 版本,必须使用2022及以上。注意,VS 2019 不支持 .Net 6,不能使用。
-   - 需要安装"使用Unity的游戏开发"扩展。
-   - 需要在"工具-选项-适用于Unity的工具-常规"里,把杂项里的禁止完整生成项目改为False,否则导致你Codes目录里的代码报错。
-
-3. 使用Rider2021.2.2(更新到最新版), 需要安装以下内容:
+   - 版本:
+      - Win10及以上用户,使用.net6, VS 版本,必须使用2022及以上。注意,VS 2019 不支持 .net6,不能使用。
+      - Win7 用户,无法安装 VS 2022,需要使用 .net 5 和 VS 2019,但注意需要额外设置以支持ET编译。
+   - 依赖:
+     - 需要安装"使用Unity的游戏开发"扩展。
+     - 需要在"工具-选项-适用于Unity的工具-常规"里,把杂项里的禁止完整生成项目改为False,否则导致你Codes目录里的代码报错。
+
+2. 使用Rider2021.2.2(更新到最新版), 需要安装以下内容:
    - Rider的Unity插件  
    - 安装 .net6  
+   - 2021.2.2 会报".NET SDK 6.0.101 is not fully supported in Rider",但实际不影响编译(2021.12.21)
+   - 2021.3.x 完全支持 .net6
+
+3. master分支需要unity2020.3版(用到了C#8的语法)  
 
-4. master分支需要unity2020.3版(用到了C#8的语法)  
+4. 启动Unity, 菜单 File -> Open Project... -> Open 选中ET/Unity文件夹,点击选择文件夹按钮。  
 
-5. 启动Unity, 菜单 File -> Open Project... -> Open 选中ET/Unity文件夹,点击选择文件夹按钮。  
+5. 点击Unity菜单 Assets -> Open C# Project 启动vs  
 
-6. 点击Unity菜单 Assets -> Open C# Project 启动vs  
+6. 运行Unity菜单上的 Tools->BuildCode,这一步将编译客户端代码  
 
-7. 运行Unity菜单上的 Tools->BuildCode,这一步将编译客户端代码  
+7. 用Rider打开 ET/Client-Server.sln 编译(**一定要全部工程编译,右键VS解决方案,全部编译**)
+   1. 先单独编译 "Client-Server/Client/Unity.Mono"
+   2. 再编译完整解决方案 "Client-Server"
 
-8. 用Rider打开 ET/Client-Server.sln 编译(**一定要全部工程编译,右键VS解决方案,全部编译**)
+8.  导表工具,编译完成后命令行进入 Bin 目录,执行 dotnet Tools.dll --AppType=ExcelExporter  
 
-9. 导表工具,编译完成后命令行进入 Bin 目录,执行 dotnet Tools.dll --AppType=ExcelExporter  
+9.  导出协议工具,编译完成后进入 Bin 目录,执行 dotnet Tools.dll --AppType=Proto2CS  
 
-10. 导出协议工具,编译完成后进入 Bin 目录,执行 dotnet Tools.dll --AppType=Proto2CS  
+10.  Unity中双击Scenes目录中的Init场景,点击Play即可运行
 
-11. Unity中双击Scenes目录中的Init场景,点击Play即可运行
 # 测试状态同步demo
 1. 想修改配置就进入 Excel 目录修改对应的表格,做运行步骤的第6步,然后重新运行 Server.App工程来启动服务端。
 
-2. Unity->tools菜单->打包工具,选择PC,勾选是否打包exe,点击开始打包,打出一个PC包在Release目录下
+2. Unity->tools菜单->打包工具,选择PC,勾选是否打包exe,点击开始打包,打出一个PC包在Release目录下
 
-4. 运行Unity 登录 进入大厅 进入场景
+3. 运行Unity 登录 进入大厅 进入场景
 
-5. 运行PC包 登录 进入大厅
+4. 运行PC包 登录 进入大厅
 
-6. 点击鼠标右键即可移动人物
+5. 点击鼠标右键即可移动人物
 
 # 注意事项:
 
@@ -45,4 +53,12 @@
 5. 没编译服务端所有工程
 6. Rider要更新到最新版本  
 7. Unity版本太低
+8. Win7 用户,没有特别设置
+9. *编译过程中如果出现依赖问题,也有可能是 Unity - External Tools - Generate .csproj files for:
+   当中勾选了 
+      1. Registry packages
+      2. Build-in packages
+10. *如果打包报错缺少"StreamingAsset",自己在 ET\Unity\Assets 下新建一个 StreamingAsset 文件夹即可。
+
+