tencent cloud

对象存储

动态与公告
产品动态
产品公告
产品简介
产品概述
功能概览
应用场景
产品优势
基本概念
地域和访问域名
规格与限制
产品计费
计费概述
计费方式
计费项
免费额度
计费示例
查看和下载账单
欠费说明
常见问题
快速入门
控制台快速入门
COSBrowser 快速入门
用户指南
创建请求
存储桶
对象
数据管理
批量处理
全球加速
监控与告警
运维中心
数据处理
内容审核
智能工具箱
数据工作流
应用集成
工具指南
工具概览
环境安装与配置
COSBrowser 工具
COSCLI 工具
COSCMD 工具
COS Migration 工具
FTP Server 工具
Hadoop 工具
COSDistCp 工具
HDFS TO COS 工具
GooseFS-Lite 工具
在线辅助工具
自助诊断工具
实践教程
概览
访问控制与权限管理
性能优化
使用 AWS S3 SDK 访问 COS
数据容灾备份
域名管理实践
图片处理实践
COS 音视频播放器实践
工作流实践
数据直传
内容审核实践
数据安全
数据校验
大数据实践
COS 成本优化解决方案
在第三方应用中使用 COS
迁移指南
本地数据迁移至 COS
第三方云存储数据迁移至 COS
以 URL 作为源地址的数据迁移至 COS
COS 之间数据迁移
Hadoop 文件系统与 COS 之间的数据迁移
数据湖存储
云原生数据湖
元数据加速
数据加速器 GooseFS
数据处理
数据处理概述
图片处理
媒体处理
内容审核
文件处理
文档处理
故障处理
获取 RequestId 操作指引
通过外网上传文件至 COS 缓慢
访问 COS 时返回403错误码
资源访问异常
POST Object 常见异常
API 文档
简介
公共请求头部
公共响应头部
错误码
请求签名
操作列表
Service 接口
Bucket 接口
Object 接口
批量处理接口
数据处理接口
任务与工作流
内容审核接口
云查毒接口
SDK 文档
SDK 概览
准备工作
Android SDK
C SDK
C++ SDK
.NET(C#) SDK
Flutter SDK
Go SDK
iOS SDK
Java SDK
JavaScript SDK
Node.js SDK
PHP SDK
Python SDK
React Native SDK
小程序 SDK
错误码
鸿蒙(Harmony) SDK
终端 SDK 质量优化
安全与合规
数据容灾
数据安全
访问管理
常见问题
热门问题
一般性问题
计费计量问题
域名合规问题
存储桶配置问题
域名和 CDN 问题
文件操作问题
日志监控问题
权限管理问题
数据处理问题
数据安全问题
预签名 URL 问题
SDK 类问题
工具类问题
API 类问题
服务协议
Service Level Agreement
隐私政策
数据处理和安全协议
联系我们
词汇表

iOS SDK 常见问题

PDF
聚焦模式
字号
最后更新时间: 2024-01-19 11:57:11

手动集成 SDK 后,设置 QCloudCOSXMLEndPoint 实例的 regionName,抛出异常 “[__NSCFConstantString matchesRegularExpression:]: unrecognized selector sent to instance xxx”,该如何处理?

原因:matchesRegularExpression 是 NSString 的分类提供的方法。Objective-C 链接器不会为每个方法建立符号表,只是为类建立了符号表。SDK 是静态库,如果静态库中定义了一份已经存在的类的分类,系统就会认为这个类已经存在,则不会将类和类的分类的代码整合起来,在最后的可执行代码中,就会缺少分类中的方法。
解决办法
1. 在 target > Build Settings > All > Other Linker Flags 中添加 -Objc-all_load 两个参数。
2. -ObjC 会将静态库中的类和分类都加载到最后的可执行文件中,但是如果库中只有分类没有类的话,这个参数就会失效,就需要 -all_load,该参数会把所有找到的目标文件都加到可执行文件中。
3. 若上述方法依然没有解决该错误,请尝试关闭 bitcode。

集成 SDK 发送请求之后抛出异常“您没有配置默认的 OCR 服务配置,请配置之后再调用该方法或者您没有配置 Key 为 'xxx' 的 OCR 服务配置,请配置之后再调用该方法”,该如何处理?

原因:SKD 所有的请求都依赖于一个 QCloudCOSXMLServeice 和 QCloudCOSTransferMangerService(上传的高级接口依赖于该实例),如果在发送请求之前没有注册对应的 service 会抛出该异常。
解决办法:通过以下代码注册请求所需要的 service 实例,并确保该实例在请求发出前已存在。
QCloudServiceConfiguration *configuration = [QCloudServiceConfiguration new];
configuration.appID = "AppId";
configuration.signatureProvider = self;
QCloudCOSXMLEndPoint *endpoint = [[QCloudCOSXMLEndPoint alloc] init];
endpoint.regionName = @"region";
endpoint.useHTTPS = YES;
configuration.endpoint = endpoint;

[QCloudCOSXMLService registerDefaultCOSXMLWithConfiguration:configuration];
[QCloudCOSTransferMangerService registerDefaultCOSTransferMangerWithConfiguration:configuration];

集成 SDK 后抛出异常“默认的 COSXMLService 已存在,如有新的配置,请通过 registerCOSXMLWithConfiguration:withKey:重新注册”,该如何处理?

原因:在 SDK 中,不同的 COSXMLService 实例对应不同的配置(配置信息可以参考相关属性),例如 regionName 为 ap-guangzhou 和 ap-beijing 是两个不同的配置,需要注册两个不同的 service,如果在用 ap-guangzhou 注册了一个 service 之后,将其 region 又改成 ap-guangzhou 重新注册就会触发该异常。
解决办法
1. 默认的 service 即通过 registerDefaultCOSXMLWithConfiguration: 不需要指定 key。
2. 通过以下代码注册一个新的 service:
//判断要注册的 key 是否存在,
if(![QCloudCOSXMLService hasServiceForKey:@"要注册的 key"]){
//不存在注册一个新的 servide
[QCloudCOSXMLService registerCOSXMLWithConfiguration:configuration withKey:@"要注册的 key"]
}

集成 SDK 之后运行,代理“- (void)signatureWithFields:(QCloudSignatureFields *)fileds request:urlRequest:compelete:”没有被调用,该如何处理?

原因:该代理方法是获取密钥/签名的方法,为了最大程度的保证密钥的有效性(调用签名过早容易过期),SDK 会在请求发出之前即 task resume 之前才会调用。
解决办法
1. 请确保该代理方法所在的类在请求发出之前不会被销毁,建议将该代理方法在一个单例类中实现。
2. 是否在创建 QCloudServiceConfiguration 实例之后,设置其 signatureProvider,例如 configuration.signatureProvider = self(self 为实现代理方法所在的类)
3. 如果以上都没问题,请检查是否发送请求。

SDK 能否缓存和复用密钥,在密钥过期之后重新请求新的密钥,该如何处理?

SDK 提供了 QCloudCredentailFenceQueue 来实现密钥的缓存和复用,具体使用方法请参考 快速入门 文档。

通过 SDK 的高级接口“QCloudCOSXMLUploadObjectRequest”抛出异常“不支持设置该类型的 body,支持的类型为 NSData、QCloudFileOffsetBody、NSURL”,该如何处理?

SDK 目前只支持设置以下三种类型的 body:
1. NSURL:文件的本地路径,通过 [NSURL fileURLWithPath:@"文件在本地的路径"] 初始化一个 URL。
2. NSData:二进制数据。
3. QCloudFileOffsetBody:分块的 body,开发者一般不需要关心该类型,属于 SDK 高级接口内部使用的 body 类型。

通过 SDK 的高级接口“QCloudCOSXMLUploadObjectRequest”上传系统图库中的视频或者文件,断点续传失败,报错“The specified Content-Length is zero”,该如何处理?

SDK 只支持续传沙盒中的文件,如需使用断点续传的功能,请先将文件移到沙盒中。

集成 SDK 后,调用上传接口上传的文件大小和本地的文件不一致,该如何处理?

请确保您设置好 body 之后,本地文件不会发生改变,例如文件在压缩过程中或者还没有完成写入之前调用了上传接口触发了上传,SDK 就会以当时的文件大小为准进行分块进行上传,从而导致上传到 cos 上的文件和本地文件大小不一致。

集成 SDK 后,调用上传接口,报错 "您输入的 body 的URL不是本地 URL,请检查后使用!"该如何处理?

解决办法: 请确保 URL 是以 file:// 开头,可以通过以下两种方式初始化 :
1. [NSURL URLWithString:@"file:////var/mobile/Containers/Data/Application/DBPF7490-D5U8-4ABF-A0AF-CC49D6A60AEB/Documents/exampleobject"]
2. [NSURL fileURLWithPath:@"/var/mobile/Containers/Data/Application/DBPF7490-D5U8-4ABF-A0AF-CC49D6A60AEB/Documents/exampleobject"]

集成 SDK 之后,调用上传接口,上传成功之后的文件大小为0,该如何处理?

解决办法:
1. 如果上传路径是文件在系统图库的路径,请检查是否有读取该文件的权限。例如:file:///var/mobile/Media/DCIM/101APPLE/ 这个路径无法直接访问,需要通过 Photos 框架里的 request 方法获取照片。
2. 如果 App 要兼容 iOS11,在上传图库视频时再调用 [[PHImageManager defaultManager] requestPlayerItemForVideo:asset options:option resultHandler:^(AVPlayerItem *playerItem, NSDictionary *info) { //及时将文件移到沙盒中或者保存 playerItem }]; 方法获取 playerItem 之后将其保存起来,或者在该回调中将要上传的文件移到 App 的沙盒中。因为 iOS11中 playerItem 被销毁之后,文件的读权限就会失效,从而导致上传的文件大小为0。
3. 如果上传的是 App 的沙盒中的文件,请检查上传的文件是否在沙盒的 tmp 文件夹下,例如 /var/mobile/Containers/Data/Application/0BFBB3FE-0FD0-46CB-ADDE-DDE08F6D62C3/tmp/,该目录下的文件会被系统随时清理,请将要上传的文件移到安全的目录,保证文件在上传的过程中不会被清理,更多关于沙盒的描述请参考 File System Basics

集成 SDK 后使用高级接口上传报错“上传过程中 MD5校验与本地不一致,请检查本地文件在上传过程中是否发生了变化:分块上传过程中,每上传完一个分块就会校验这个分块的 MD5 和本地片的 MD5 是否一致,不一致就报错”,该如何处理?

原因:该错误发生在上传大于1MB的文件的情况下,超过1MB的文件使用 SDK 上传时会根据将文件分成若干个1MB的文件进行分块上传,在上传完每一个分块之后会用后台返回的 etag 和本地文件的分块进行对比,如果发现不一致会抛出该错误。
解决办法:请检查文件在上传的过程中是否发生改变。

SDK 能否使用 CDN 加速域名进行访问?

支持,请根据您所使用的编程语言,并参见对应的SDK 文档进行操作。

SDK 如何设置请求的超时时间?

解决:SDK 5.7.0 之后支持自定义请求的超时时间,可以通过以下方式设置:
1. 初始化 QCloudServiceConfiguration *config = [QCloudServiceConfiguration new]
2. 设置 config 的 timeoutInterval 属性即可,例如设置 config 的.timeoutInterval = 30;

COS iOS SDK 出现 crash,该如何处理?

请检查当前版本是否为最新版本,若是旧版本建议您升级到最新的 SDK 版本。最新版本 iOS SDK 请参见 qcloud-sdk-ios

“Undefined symbols for architecture arm64: "_ne10 init dsp", referenced from:”类错误,该如何处理?

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈