文档中心

日志服务

请输入

iOS SDK（ v2.x）

iOS SDK 概述（v2.x）

火山引擎日志服务 iOS SDK v2.x 封装了日志服务的日志采集接口，提供面向 Apple 平台的异步日志上传 Producer（ VolcengineTLSProducer），为 iOS 和原生 macOS 应用提供高吞吐异步日志写入能力。

版本说明

火山引擎日志服务 iOS SDK 的更新日志及版本说明请查看 GitHub。建议您选择最新版本 SDK，体验更新的产品能力和更稳定的服务。

iOS SDK v2.x 仅负责日志上传，不提供查询、消费、告警或数据加工接口，提供 Swift、Objective-C。

示例项目

日志服务 TLS iOS SDK 为您提供示例项目供您参考，详情请参考 Github 示例项目仓库。

GitHub 源码	说明
ve-tls-ios-sdk-v2.x	面向 Apple 平台的 Volcengine TLS 异步日志上传 Producer。提供 Swift 和 Objective-C 接口，但不兼容 v1.x 的类名和方法。支持 iOS、iPadOS 和原生 macOS，提供批处理、压缩、重试、背压和可选 WAL。

参考文档

参考文档	说明
概述	VolcengineTLSProducer 为 iOS 和原生 macOS 应用提供高吞吐异步日志写入能力。它在调用方线程完成本地接收，随后在后台聚合、压缩并发送日志。
安装	VolcengineTLSProducer SDK 的环境要求，安装步骤和版本选择。
Objective-C 接入	使用 Producer v2 上传日志，不需要在业务 target 中添加 Swift 源文件。 SDK 内部仍包含 Swift，实现与 Swift Producer 共用，但不是旧版 v1.x 客户端的兼容层。
验证写入	仅凭 add 返回成功无法判断接入完成，验证应同时覆盖本地接收、批次回调和服务端查询。
配置参数	ProducerConfiguration 是可变值类型。初始化时会校验参数，Producer.open 还会重新校验并保存当时的配置。打开成功后，修改原配置不会影响正在运行的 Producer。
平台兼容性	产品平台，工具链，接入方式的兼容性。
持久化与恢复	持久化用于在进程异常退出、设备重启或长时间离线后恢复尚未确认的数据。提供 at-least-once 交付基础，不提供 exactly-once。
故障排查	排查时先确定失败发生在哪个边界：open、本地 add、异步批次回调、服务端查询，还是 close，这些阶段的成功含义不同。
性能参考	性能结果与设备、系统、日志大小、持久化方式和网络条件强相关。相关数据用于估算资源开销，结果用于选型和配置参考，不作为吞吐上限或服务保证。

最近更新时间：2026.10.27 16:04:18

这个页面对您有帮助吗？

有用

无用