# 5.7.5

- 5.7.5:增加crc检验\- 新增background优先级\- 修复iOS14频繁弹出剪贴板的问题\- 支持上传时添加盲水印\- 修复list多版本文件bug\- 增加截屏接口

Author: karisli

CHANGELOG.md

@@ -1,3 +1,11 @@
+# 5.7.5    
+- 增加crc检验
+- 新增background优先级
+- 修复iOS14频繁弹出剪贴板的问题
+- 支持上传时添加盲水印
+- 修复list多版本文件bug
+- 增加截屏接口
+    
 # 5.7.4    
 一些修复
 

QCloudCOSXML.podspec

@@ -1,7 +1,7 @@
 Pod::Spec.new do |s|
   s.name             = "QCloudCOSXML"
 
-s.version              = "5.7.4"
+s.version              = "5.7.5"
 
   s.summary          = "QCloudCOSXML 腾讯云iOS-SDK组件"
 
@@ -17,15 +17,15 @@ s.version              = "5.7.4"
   s.default_subspec = 'Default'
   s.subspec 'Default' do |default|
   default.source_files = 'QCloudCOSXML/Classes/**/*','Models/request.model','QCloudCOSXML/Classes/QCloudCOSXML/*'
-  default.dependency "QCloudCore",'5.7.4'
+  default.dependency "QCloudCore",'5.7.5'
     end
   s.subspec 'Slim' do |slim|
   slim.source_files = 'QCloudCOSXML/Classes/**/*','Models/request.model','QCloudCOSXML/Classes/QCloudCOSXML/*'
-  slim.dependency "QCloudCore/WithoutMTA",'5.7.4'
+  slim.dependency "QCloudCore/WithoutMTA",'5.7.5'
   end
   s.subspec 'Transfer' do |transfer|
   transfer.source_files = 'QCloudCOSXML/Classes/*','QCloudCOSXML/Classes/Transfer/**/*','QCloudCOSXML/Classes/Base/*'
-  transfer.dependency "QCloudCore/WithoutMTA",'5.7.4'
+  transfer.dependency "QCloudCore/WithoutMTA",'5.7.5'
   end
 
 end

QCloudCOSXML/Classes/Base/QCloudCOSXMLEndPoint.h

@@ -10,9 +10,14 @@
 #pragma clang diagnostic push
 #pragma clang diagnostic ignored "-Wobjc-property-synthesis"
 
+/**
+ QCloudServiceConfiguration 类的 endpoint 参数
+ */
+
 @interface QCloudCOSXMLEndPoint : QCloudEndPoint
 /**
- 服务地域名称,可用的服务地域名称请查看官网https://www.qcloud.com/document/product/436/6224中提供的地域，这里填入官网里提供的地域简称，例如ap-beijing-1等。
+ * 服务地域名称,可用的服务地域名称请查看官网https://www.qcloud.com/document/product/436/6224
+ * 中提供的地域，这里填入官网里提供的地域简称，例如ap-beijing等。
  */
 @property (nonatomic, copy) QCloudRegion        regionName;
 @property (nonatomic,assign)BOOL isPrefixURL;
@@ -23,7 +28,9 @@
 
 /**
  自定义域名：http://bucketname.suffix
- */
+ 未指定该参数，该存储桶host为 http://bucketname.****
+ 指定该参数为testsuffix，该存储桶host为 http://bucketname.testsuffix.****
+*/
 @property (nonatomic, copy) NSString *suffix;
 @end
 

QCloudCOSXML/Classes/Base/QCloudCOSXMLService.h

@@ -31,6 +31,39 @@
 #import <QCloudCore/QCloudCore.h>
 
 NS_ASSUME_NONNULL_BEGIN
+
+/**
+ QCloudCOSXMLService 是对所有接口请求发起的封装；通过QCloudCOSXMLService实例来发起网络请求
+ 
+ 详情请查看：https://cloud.tencent.com/document/product/436/11280
+ 
+
+ 配置QCloudCOSXMLService
+ 1：实例化 QCloudServiceConfiguration 对象：
+ 
+    QCloudServiceConfiguration* configuration = [QCloudServiceConfiguration new];
+    configuration.appID = @"APPID"  //腾讯云账号的 APPID;
+ 
+ 2:实例化 QCloudCOSXMLService 对象：
+ 
+    + (QCloudCOSXMLService*) registerDefaultCOSXMLWithConfiguration
+    :(QCloudServiceConfiguration*)configuration;
+ 
+ 3：实例化 QCloudCOSTransferManagerService 对象：
+ 
+    + (QCloudCOSTransferMangerService*) registerDefaultCOSTransferMangerWithConfiguration
+    :(QCloudServiceConfiguration*)configuration;
+ 
+ 使用步骤：
+ 
+ 1：实例并初始化好要使用的request；
+ 
+ 2：使用[QCloudCOSXMLService defaultCOSXML] 获取到 QCloudCOSXMLService实例；
+ 
+ 3：调用对应发起请求的方法：如get****,post****,put****,delete****,
+ 
+ */
+
 @interface QCloudCOSXMLService : QCloudService
 #pragma hidden super selectors
 - (int) performRequest:(QCloudBizHTTPRequest *)httpRequst NS_UNAVAILABLE;
@@ -67,10 +100,12 @@ NS_ASSUME_NONNULL_BEGIN
 + (void) removeCOSXMLWithKey:(NSString*)key;
 
 /**
-根据Bukcet, Object来生成可以直接访问的URL。如果您的Bucket是私有读的话，那么访问的时候需要带上签名，反之则不需要。
+根据Bukcet, Object来生成可以直接访问的URL。如果您的Bucket是私有读的话，那么访问的时候需要带上签名，
+ 反之则不需要。
  
  
-需要注意的是，如果通过该接口来生成带签名的URL的话，因为签名可能是在服务器生成的，该方法是同步方法，可能因为网络请求阻塞，建议不要在主线程里调用。
+需要注意的是，如果通过该接口来生成带签名的URL的话，因为签名可能是在服务器生成的，该方法是同步方法，
+ 可能因为网络请求阻塞，建议不要在主线程里调用。
 
 此外, 传入的Object需要是URLEncode后的结果。
  

QCloudCOSXML/Classes/Base/QCloudLogManager.h

@@ -9,11 +9,27 @@
 
 NS_ASSUME_NONNULL_BEGIN
 
+/**
+ QCloudCOSXML 日志管理类
+ */
 @interface QCloudLogManager : NSObject
+/**
+ 是否显示日志信息
+ */
+@property (nonatomic,assign)BOOL shouldShowLog;
 + (instancetype) sharedInstance;
 
+/**
+ 已经产生的日志
+ */
 - (NSArray *)currentLogs;
+
+/**
+ 根据日志路径读取日志
+ @params path 日志路径
+ */
 - (NSString *) readLog:(NSString *)path;
+- (BOOL)shouldShowLog;
 @end
 
 NS_ASSUME_NONNULL_END

QCloudCOSXML/Classes/Base/QCloudLogManager.m

@@ -125,38 +125,36 @@ + (instancetype) sharedInstance {
 - (instancetype) init {
     self = [super init];
 
-    [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(onHandleAppBecomeActive:) name:UIApplicationDidBecomeActiveNotification object:nil];
+    [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(onHandleDidFinishLaunching:) name:UIApplicationDidFinishLaunchingNotification object:nil];
     return self;
 }
 
 - (void)dealloc {
     [[NSNotificationCenter defaultCenter] removeObserver:self];
 }
-- (void) onHandleAppBecomeActive :(NSNotification *)notification {
-    
+- (void) onHandleDidFinishLaunching :(NSNotification *)notification {
+    if (!self.shouldShowLog) {
+        return;
+    }
+    //    如果剪贴板没有数据则不进行读取，减少ios14 剪贴板弹框次数
+    if (@available(iOS 10.0, *)) {
+        if (![[UIPasteboard generalPasteboard] hasStrings]) {
+            return;
+        }
+    }
     dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{
-        //
         NSString *currentPasteBoardContent = [UIPasteboard generalPasteboard].string;
            if ([currentPasteBoardContent isEqualToString:@"##qcloud-cos-log-ispct##"]) {
               [UIPasteboard generalPasteboard].string = @"";
               dispatch_async(dispatch_get_main_queue(), ^{
                     [self showLogs];
                });
-           
+
            }
     });
 }
 
 
-- (BOOL) shouldShowLogs {
-    NSString *currentPasteBoardContent = [UIPasteboard generalPasteboard].string;
-    if ([currentPasteBoardContent isEqualToString:@"##qcloud-cos-log-ispct##"]) {
-        return YES;
-    }
-    return NO;
-}
-
-
 - (NSArray *)currentLogs {
     NSString *directoryPath = [QCloudLogger sharedLogger].logDirctoryPath;
     NSArray *content = [[NSFileManager defaultManager] contentsOfDirectoryAtPath:directoryPath error:nil];

QCloudCOSXML/Classes/Base/QCloudPicOperations.h

@@ -0,0 +1,76 @@
+//
+//  QCloudPutObjectWatermarkInfo.h
+//  Pods-QCloudCOSXMLDemo
+//
+//  Created by garenwang on 2020/6/4.
+//
+
+#import <Foundation/Foundation.h>
+@class QCloudPicOperationRule;
+
+NS_ASSUME_NONNULL_BEGIN
+
+typedef NS_ENUM(NSUInteger, QCloudPicOperationRuleEnum) {
+    QCloudPicOperationRuleHalf = 1, /// 抗攻击性强，但提取水印需原图 使用场景：小图（640x640以下）使用
+    QCloudPicOperationRuleFull,     /// 提取方便，提取水印仅需水印图，无需对比原图 使用场景：批量添加，批量校验
+    QCloudPicOperationRuleText,     /// 可直接将文字信息添加至图片中 使用场景：终端信息添加
+};
+
+/**
+ 图片添加盲水印接口 参数类
+ 包含水印规则，水印类型，水印参数
+ */
+@interface QCloudPicOperations : NSObject
+
+
+/// 是否返回原图信息。0表示不返回原图信息，1表示返回原图信息，默认为0
+@property (nonatomic,assign)BOOL is_pic_info;
+
+
+/// 处理规则，一条规则对应一个处理结果（目前最多支持五条规则），不填则不进行图片处理
+@property (nonatomic,copy)NSArray <QCloudPicOperationRule *> * rule;
+
+-(NSString *)getPicOperationsJson;
+
+@end
+
+/**
+ 给图片添加水印规则
+ */
+@interface QCloudPicOperationRule : NSObject
+
+/// 处理结果的文件路径名称，如以/开头，则存入指定文件夹中，否则，存入原图文件存储的同目录
+@property (nonatomic,copy)NSString * fileid;
+
+/// 处理参数，参见数据万象图片处理 API。 若按指定样式处理，则以style/开头，后加样式名，如样式名为“test”，
+/// 则 rule 字段为style/test
+@property (nonatomic,copy)NSString * rule;
+
+/// 盲水印类型，有效值：1 半盲；2 全盲；3 文字
+@property (nonatomic,assign)QCloudPicOperationRuleEnum type;
+
+/**
+ 盲水印图片地址，需要经过 URL 安全的 Base64 编码。 当 type 为1或2时必填，type 为3时无效。
+    指定的水印图片必须同时满足如下 3 个条件：
+ 1. 盲水印图片与原图片必须位于同一个对象存储桶下；
+ 2. URL 需使用数据万象源站域名（不能使用 CDN 加速、COS 源站域名），例如
+    examplebucket-1250000000.image.myqcloud.com属于 CDN 加速域名，不能在水印 URL 中使用；
+ 3. URL 必须以http://开始，不能省略http头，
+ 也不能填https头，例如examplebucket-1250000000.picsh.myqcloud.com/shuiyin_2.png，
+ https://examplebucket-1250000000.picsh.myqcloud.com/shuiyin_2.png
+ 就是非法的水印 URL。
+ */
+@property (nonatomic,copy)NSString * imageURL;
+
+/**
+ 盲水印文字，需要经过 URL 安全的 Base64 编码。当 type 为3时必填，type 为1或2时无效。
+ */
+@property (nonatomic,copy)NSString * text;
+
+/// 只对全盲水印（type=2）有效。level 的取值范围为{1,2,3}，默认值为1，level
+/// 值越大则图片受影响程度越大、盲水印效果越好。
+@property (nonatomic,assign)NSInteger level;
+
+@end
+
+NS_ASSUME_NONNULL_END

QCloudCOSXML/Classes/Base/QCloudPicOperations.m

@@ -0,0 +1,101 @@
+//
+//  QCloudPutObjectWatermarkInfo.m
+//  Pods-QCloudCOSXMLDemo
+//
+//  Created by garenwang on 2020/6/4.
+//
+
+#import "QCloudPicOperations.h"
+#import <QCloudCore/QCloudLogger.h>
+#import <QCloudCore/QCloudCore.h>
+#import "NSString+RegularExpressionCategory.h"
+
+@implementation QCloudPicOperations
+
+-(NSString *)getPicOperationsJson{
+    if ([self getRules] == nil) {
+        return nil;
+    }
+    
+    NSDictionary *dicOperations = @{@"is_pic_info":_is_pic_info ? @(1):@(0),@"rules":[self getRules]};
+    QCloudLogInfo(@"水印生成成功————%@",[dicOperations qcloud_modelToJSONString]);
+    return [dicOperations qcloud_modelToJSONString];
+}
+
+-(NSArray *)getRules{
+    NSMutableArray * rules = [NSMutableArray arrayWithCapacity:0];
+    for (QCloudPicOperationRule * item in _rule) {
+        if (item.rule == nil ) {
+            return nil;
+        }
+        
+        if (item.fileid == nil) {
+            QCloudLogError(@"[%@]QCloudPicOperationRule的fileid不能为空",self.class);
+            return nil;
+        }
+        
+        [rules addObject:@{@"fileid":item.fileid,@"rule":item.rule}];
+    }
+    if (rules.count > 5) {
+        return [rules subarrayWithRange:NSMakeRange(0, 5)];
+    }
+    return rules.copy;
+}
+
+@end
+
+@implementation QCloudPicOperationRule
+
+-(NSString *)rule{
+    //    直接指定rule；若无指定，则按照用户输入生成rule;
+    if (_rule != nil) {
+        return _rule;
+    }
+    
+    if (_type == 0 || _type > 3) {
+        QCloudLogError(@"水印类型错误");
+        return nil;
+    }
+    
+    NSMutableString * strRule = [NSMutableString stringWithString:@"watermark/3/type"];
+    
+    [strRule appendFormat:@"/%ld",_type];
+    
+    if (_type == QCloudPicOperationRuleFull || _type == QCloudPicOperationRuleHalf) {
+        if (_imageURL == nil) {
+            QCloudLogError(@"[%@]生成水印错误————半盲和全盲水印必须指定图片链接",self.class);
+            return nil;
+        }
+        NSData *data = [_imageURL dataUsingEncoding:NSUTF8StringEncoding];
+        NSString* base64ImageUrl = [data base64EncodedStringWithOptions:0];
+        [strRule appendFormat:@"/image/%@",base64ImageUrl];
+        if (_type == QCloudPicOperationRuleFull) {
+            if (_level < 1) {
+                [strRule appendString:@"/level/1"];
+            }else if (_level > 3) {
+                [strRule appendString:@"/level/3"];
+            }else{
+                [strRule appendFormat:@"/level/%ld",_level];
+            }
+        }
+    }else{
+        if (_text == nil) {
+            QCloudLogError(@"[%@]文本型水印请传入水印文字",self.class);
+            return nil;
+        }
+        
+        if (![_text matchesRegularExpression:@"[a-zA-Z0-9]+"]) {
+            QCloudLogError(@"[%@]文本型水印的文本仅支持[a-zA-Z0-9]",self.class);
+            return nil;
+        }
+        
+        [strRule appendFormat:@"/text/%@",_text];
+    }
+    
+    return strRule;
+}
+
+
+@end
+
+

QCloudCOSXML/Classes/Base/select/QCloudInputSerialization.h

@@ -32,6 +32,9 @@
 #import "QCloudSerializationJSON.h"
 
 NS_ASSUME_NONNULL_BEGIN
+/**
+ 描述待检索对象的格式
+ */
 @interface QCloudInputSerialization : NSObject
 /**
 描述待检索对象的压缩格式：

QCloudCOSXML/Classes/Base/select/QCloudOutputSerialization.h

@@ -31,6 +31,9 @@
 #import "QCloudSerializationJSON.h"
 
 NS_ASSUME_NONNULL_BEGIN
+/**
+描述检索结果的输出格式
+*/
 @interface QCloudOutputSerialization : NSObject
 /**
      描述在CSV对象格式下所需的文件参数。