更新 xcode升级到15.x版本后zlib库中的编译错误相关文档

Author: pirunxi

docs/help/commonerrors.md

@@ -252,12 +252,16 @@ WebGL使用全局安装，你没有将本地`{project}/HybridCLRData/LocalIl2Cpp
 在热更新代码中定义的添加了`[MonoPInvokeCallback]`特性的函数不支持string或者数组之类的参数或者返回值，请将相应参数修改为IntPtr同时自行marshal这些参数，或者将该函数移到AOT中定义。
 详细请见[MonoPInvokCallback支持](../basic/monopinvokecallback)。
 
-### 升级到最新版本xcode后出现发布ios平台时出现 stdio.h头文件中fopen函数的编译错误
+### 升级到最新版本xcode后发布ios平台时在stdio.h（或_studio）头文件中出现fopen函数相关或`unexpectd )`之类的编译错误
 
 在升级xcode 15.x版本后出现跟zlib的不兼容问题。解决办法有两个：
 
 - xcode回退到13.x版本
-- zlib升级到最新版本，替换`{project}/HybridCLRData/LocalIl2CppData-{platform}/il2cpp/external/zlib`目录的代码，清理Library缓存后重新打包
+- zlib升级到最新版本，具体操作如下：
+  - 从 [zlib官网](https://zlib.net) 下载最新版本的[zlib源码](https://zlib.net/current/zlib.tar.gz)。如果最新版本仍然遇到问题（可能性不高），请下载我们已经验证过的1.3.2版本。
+  - 解压代码压缩包，删除根目录下除了 `.h`和`.c`文件以外的所有文件（此操作**可选**，不影响构建）。
+  - 使用刚刚解压的zlib的源码目录替换`{project}/HybridCLRData/LocalIl2CppData-{platform}/il2cpp/external/zlib`目录的代码。
+  - 清理Library缓存后重新打包。
 
 ## 运行时错误
 

i18n/en/docusaurus-plugin-content-docs/current/help/commonerrors.md

@@ -251,13 +251,16 @@ Extern functions defined in hot update code don't support parameters or return v
 Functions with `[MonoPInvokeCallback]` attribute defined in hot update code don't support parameters or return values like string or arrays. Please modify the corresponding parameters to IntPtr and manually marshal these parameters, or move the function to AOT for definition.
 For details, see [MonoPInvokCallback Support](../basic/monopinvokecallback).
 
-### After upgrading to the latest version of Xcode, a compilation error occurs with the fopen function in the stdio.h header when publishing for the iOS platform After upgrading to Xcode 15.x
+### Compilation errors related to `fopen` or messages like `unexpected )` appearing in `stdio.h` (or `_stdio`) when building for iOS after upgrading to the latest Xcode
 
-an incompatibility issue with zlib arises. There are two solutions:
+After upgrading to Xcode 15.x, compatibility issues with zlib may occur. There are two possible solutions:
 
 - Roll back Xcode to version 13.x
-
-- Upgrade zlib to the latest version by replacing the code in the `{project}/HybridCLRData/LocalIl2CppData-{platform}/il2cpp/external/zlib` directory. clean build cache in Library. rebuild your game.
+- Upgrade zlib to the latest version. The steps are as follows:
+  - Download the latest version of the zlib source code from the official website: https://zlib.net (e.g., https://zlib.net/current/zlib.tar.gz). If the latest version still encounters issues (unlikely), please use version 1.3.2, which we have already verified.
+  - Extract the archive, and remove all files in the root directory except for `.h` and `.c` files (this step is **optional** and does not affect the build).
+  - Replace the contents of `{project}/HybridCLRData/LocalIl2CppData-{platform}/il2cpp/external/zlib` with the extracted zlib source code.
+  - Clear the Library cache and rebuild the project.
 
 ## Runtime Errors
 

i18n/en/docusaurus-plugin-content-docs/version-8.5.0/help/commonerrors.md

@@ -251,13 +251,16 @@ Extern functions defined in hot update code don't support parameters or return v
 Functions with `[MonoPInvokeCallback]` attribute defined in hot update code don't support parameters or return values like string or arrays. Please modify the corresponding parameters to IntPtr and manually marshal these parameters, or move the function to AOT for definition.
 For details, see [MonoPInvokCallback Support](../basic/monopinvokecallback).
 
-### After upgrading to the latest version of Xcode, a compilation error occurs with the fopen function in the stdio.h header when publishing for the iOS platform After upgrading to Xcode 15.x
+### Compilation errors related to `fopen` or messages like `unexpected )` appearing in `stdio.h` (or `_stdio`) when building for iOS after upgrading to the latest Xcode
 
-an incompatibility issue with zlib arises. There are two solutions:
+After upgrading to Xcode 15.x, compatibility issues with zlib may occur. There are two possible solutions:
 
 - Roll back Xcode to version 13.x
-
-- Upgrade zlib to the latest version by replacing the code in the `{project}/HybridCLRData/LocalIl2CppData-{platform}/il2cpp/external/zlib` directory. clean build cache in Library. rebuild your game.
+- Upgrade zlib to the latest version. The steps are as follows:
+  - Download the latest version of the zlib source code from the official website: https://zlib.net (e.g., https://zlib.net/current/zlib.tar.gz). If the latest version still encounters issues (unlikely), please use version 1.3.2, which we have already verified.
+  - Extract the archive, and remove all files in the root directory except for `.h` and `.c` files (this step is **optional** and does not affect the build).
+  - Replace the contents of `{project}/HybridCLRData/LocalIl2CppData-{platform}/il2cpp/external/zlib` with the extracted zlib source code.
+  - Clear the Library cache and rebuild the project.
 
 ## Runtime Errors
 

versioned_docs/version-8.5.0/help/commonerrors.md

@@ -254,10 +254,16 @@ WebGL使用全局安装，你没有将本地`{project}/HybridCLRData/LocalIl2Cpp
 
 ### 升级到最新版本xcode后出现发布ios平台时出现 stdio.h头文件中fopen函数的编译错误
 
+### 升级到最新版本xcode后发布ios平台时在stdio.h（或_studio）头文件中出现fopen函数相关或`unexpectd )`之类的编译错误
+
 在升级xcode 15.x版本后出现跟zlib的不兼容问题。解决办法有两个：
 
 - xcode回退到13.x版本
-- zlib升级到最新版本，替换`{project}/HybridCLRData/LocalIl2CppData-{platform}/il2cpp/external/zlib`目录的代码，清理Library缓存后重新打包
+- zlib升级到最新版本，具体操作如下：
+  - 从 [zlib官网](https://zlib.net) 下载最新版本的[zlib源码](https://zlib.net/current/zlib.tar.gz)。如果最新版本仍然遇到问题（可能性不高），请下载我们已经验证过的1.3.2版本。
+  - 解压代码压缩包，删除根目录下除了 `.h`和`.c`文件以外的所有文件（此操作**可选**，不影响构建）。
+  - 使用刚刚解压的zlib的源码目录替换`{project}/HybridCLRData/LocalIl2CppData-{platform}/il2cpp/external/zlib`目录的代码。
+  - 清理Library缓存后重新打包。
 
 ## 运行时错误