如何设置和获取 ZIM SDK 的日志信息？
2025-09-26
各平台根据以下方式，可设置和获取 ZIM SDK 的日志信息。
Android
“/storage/Android/data/[应用包名]/files/ZIMLogs” 路径下，以 “zimlog” 开头的 TXT 文件为日志信息。
以设置日志存储路径为 “/data/user/0/包名/files”，单个日志文件大小上限为 5MB 为例：
ZIMLogConfig logConfig;
// 设置日志存储路径
logConfig.logPath = getApplicationContext().getFilesDir().getAbsolutePath();
// 设置单个日志文件大小上限
logConfig.logSize = 5242880L;
ZIM.setLogConfig(logConfig);API 参考：ZIMLogConfig、setLogConfig
iOS/iPadOS
- 将 iOS 设备连接到 Mac，打开 Xcode，顶部菜单栏选择 “Window > Devices and Simulators”。
- 左侧选择指定设备，然后在 “INSTALLED APPS” 中找到需要取日志的 App， 单击下方齿轮图标，选择 “Download Container...” 并保存。
- 打开“访达”找到保存的 “.xcappdata” 文件，右键选择 “显示包内容”，选择 “AppData > Library > Caches > ZIMLogs` 目录，以 “zimlog” 开头的 TXT 格式文件为日志信息。
以设置日志存储路径为 “[[NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) lastObject] stringByAppendingString:@"/ZegoLogs"]”，单个日志文件大小上限为 5MB 为例：
// 设置日志存储路径
NSString *appLogPath = [[NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) lastObject] stringByAppendingString:@"/ZegoLogs"];
ZIMLogConfig *logConfig = [[ZIMLogConfig alloc] init];
logConfig.logPath = appLogPath;
// 设置单个日志文件大小上限
logConfig.logSize = 5 * 1024 * 1024;
[ZIM setLogConfig:logConfig];API 参考：
- iOS：ZIMLogConfig、setLogConfig
- macOS：ZIMLogConfig、setLogConfig
macOS
- 沙箱：“~/Library/Containers/[应用包名 Bundle ID]/Data/Library/Caches/ZIMLogs” 路径下，以 “zimlog” 开头的 TXT 文件为日志信息。
- 非沙箱：“~/Library/Caches/ZIMLogs” 路径下，以 “zimlog” 开头的 TXT 文件为日志信息。
Windows
日志文件夹的命名为：“程序的进程名字”+“ZEGO.SDK”。 在 “我的电脑” 路径下直接输入 “%APPDATA%” 并回车，即可定位到日志文件夹存放目录。以 “zimlog” 开头的 TXT 文件为日志信息。
以设置日志存储路径为 “/Users/zego/Log/log.txt”，单个日志文件大小上限为 5MB 为例：
ZIMLogConfig logConfig;
// 设置日志存储路径
logConfig.logPath = "/Users/zego/Log/log.txt";
// 设置单个日志文件大小上限
logConfig.logSize = 5242880L;
ZIM::setLogConfig(logConfig);API 参考：ZIMLogConfig、setLogConfig
Web/小程序
Web 和小程序平台无法获取本地日志文件，请开发者在调用 login 接口之后，通过 uploadLog 接口，将日志上传到 ZEGO 日志中心。
其他平台
使用 Flutter、Unity3D、uni-app、React Native 等跨平台框架时，参考上文的原生平台（iOS、Android、macOS、Windows、Web）的方式获取日志即可。