geeteam / gt3-ios-sdk

Geetest 3.0 iOS Objective-C SDK

本仓库已停止维护。通过依赖管理或手动方式获取最新 SDK 请访问 iOS SDK 及 Demo 下载地址

GT3Captcha Project

概述

极验验证 3.0 iOS SDK 提供给集成 iOS 原生客户端开发的开发者使用, SDK 不依赖任何第三方库.

• Bitcode 版本在 Bitcode 目录下的 GT3Captcha.framework及GT3Captcha.Bundle
• 非 Bitcode 版本在 GT3Example 目录下的 GT3Captcha.framework及GT3Captcha.Bundle

环境需求

条目
开发目标	兼容 iOS7, 推荐 iOS8+
开发环境	Xcode 8.0
系统依赖	Webkit.framework, JavaScriptCore.framework
SDK 三方依赖	无
资源依赖	依赖 GT3Captcha.Bundle

获取 SDK

使用 git 命令从 Github 获取

git clone https://github.com/GeeTeam/gt3-ios-objc.git

手动下载获取

使用从 github 下载.zip文件获取最新的 SDK.

Github: gt3-ios-objc

使用

引入 GT3Captcha.framework

使用 Linked Frameworks and Libraries 方式引入 GT3Captcha.framework. GT3Captcha.framework 是 Static Library, 支持 iOS7+.

引入 GT3Captcha.Bundle

把仓库中的 GT3Captcha.Bundle 拖入项目中. iOS7 不支持 Dynamic Library, 无法使用 embedded binaries. 而 Dynamic Library 无法获取 .strings 等资源文件, 这里以 bundle 外嵌的方式单独管理 SDK 所需资源文件.

如需自定义按钮的标题请查阅 tipsDict 相关定义

Demo 提供的示例场景

使用参见根部目录下的 GT3Example Demo 工程, Demo 包含以下场景:

1. 在登录使用 SDK 默认封装接口 LoginViewController
2. 在注册使用 SDK 默认封装接口RegisterViewController
3. 在自定义按钮下使用 SDK 默认封装接口 CustomButton
4. 在自定义按钮下使用自定义接口 AsyncButton

语言环境配置

Demo 以 iOS8 作为示例, 语言默认支持中文简体、中文繁体、英文，但需要在 .plist 里添加如下属性(已存在的不用再次添加):

<key>CFBundleLocalizations</key>
	<array>
		<string>en</string>
		<string>zh_CN</string>
		<string>zh_TW</string>
	</array>

SDK 及产品详情

极验验证 3.0 服务介绍 服务介绍

SDK 安装教程见 官方文档

SDK 接口文档见 接口文档

接口

集成前需要先了解极验验证 3.0 的产品结构, 并且必须要先在您的后端搭建相应的服务端 SDK，并配置从 极验后台 获取的 <gt_captcha_id> 和 <geetest_key>用来配置您集成了极验服务端 SDK 的后台.

其中 iOS SDK 主要提供以下接口:

1. 配置验证初始化
2. 启动验证
3. 验证生命周期的代理方法
   • 错误处理
   • 结果处理
   • 流程控制

更新日志

• 0.10.2: 新增日语支持; 优化内部流程;
• 0.10.1: 优化网络模块; 优化内部状态控制; 功能增强; 新增印尼语支持; 其它问题修复;
• 0.9.0: 添加 GT3Captcha.Bundle, 为 Static Library 单独管理图片、文件等资源;
• 0.8.10: 修复潜在 bug; 增强统计接口;
• 0.8.8: 修复潜在的 crash 问题; 修复内存泄漏; 增加 debug 代理;
• 0.8.6: 紧急修复 openURL: 在 iOS11 上导致的 crash 问题;
• 0.8.5: 优化高度获取方案; 其他问题修复;
• 0.8.1: 修复 iOS8+ 网络 bug; 细节优化;
• 0.7.10: 错误统一; UI 逻辑调整;
• 0.7.6: 改善数据; 其他问题修复;
• 0.7.2: 改善数据交互; 增加 forbidden 事件;
• 0.6.3: 修复 onepass 下没有图形提示的问题; 修复因状态不一致导致的 server 返回 'runtime error';
• 0.6.2: 解决 0.6.1 版在部分情况下, 执行动画导致 CPU 高消费; 解决已发现在数据层面导致的服务端返回 'runtime error' 的问题;
• 0.6.1: 针对按钮绑定集成验证优化；针对反馈提供更多新接口；改善初始化体验；提供更详实的演示 Demo;
• 0.5.7: 修正 NSBundle 在非 embedded binaries 中的问题;
• 0.5.6: 修改提示文案；GTCaptchaManagerViewDelegate 方法更新；验证成功后再次验证只需要点击一次;
• 0.5.5: 对 GT3CaptchaButton 增加可选的代理方法;
• 0.5.4: 完善验证管理器生命周期;
• 0.5.3: 修复在未检测到传感器的情况下的表现行为；优化销毁逻辑;
• 0.5.2: 修改多交互逻辑, 界面适配修正;
• 0.5.0: 变更为静态库以支持 iOS7；支持静默验证；少量修复和改善;

gt3-ios-sdk's Issues

为什么我使用bitcode的sdk，还是只能关闭bitcode才可以编译成功？

使用bitcode文件夹下的sdk，替换了demo里面的sdk，把Enable Bitcode设置为YES,编译不通过，提示
GT3Captcha.framework/GT3Captcha(GT3ActivityIndicatorView.o)' does not contain bitcode.

是我操作的姿势不正确吗？

希望添加pod支持

希望添加pod支持，方便引用

添加入pod之后报错. +[NSBundle gt3_resourcesBundle]: unrecognized selector sent to class 0x106f6dbb8

添加入pod之后报错.
+[NSBundle gt3_resourcesBundle]: unrecognized selector sent to class 0x106f6dbb8

GTCaptchaButton 支持xib

能支持bitcode吗？

能支持bitcode吗？

Found an unexpected Mach-O header code:

在swift工程里 直接不能打包，出现这个

ITMS-90809: Deprecated API Usage

提审后被拒绝
TMS-90809: Deprecated API Usage - New apps that use UIWebView are no longer accepted. Instead, use WKWebView for improved security and reliability. Learn more (https://developer.apple.com/documentation/uikit/uiwebview).

项目目录下 grep -r UIWebView .
提示 /Frameworks/GT3Captcha.framework/GT3Captcha matches

麻烦请问 /GT3Captcha.framework/ 是否包含UIWebView API？

感谢

极验没有社区论坛吗？

想问下二次认证用了-(BOOL)shouldUseDefaultSecondaryValidate 为NO
- (void)gtCaptcha:(GT3CaptchaManager *)manager didReceiveCaptchaCode:(NSString *)code result:(NSDictionary *)result message:(NSString *)message;
还需要实现这个
-(void) response:(NSURLResponse *)response error:(GT3Error *)error decisionHandler:(void (^)(GT3SecondaryCaptchaPolicy captchaPolicy))decisionHandler;
吗？

验证弹窗 闪一下 就没了

master分支的回调方法没有走

测试demo也没有回调，是配置问题还是什么问题

• (void)gtCaptcha:(GT3CaptchaManager *)manager didReceiveSecondaryCaptchaData:(NSData *)data response:(NSURLResponse *)response error:(GT3Error *)error decisionHandler:(void (^)(GT3SecondaryCaptchaPolicy))decisionHandler {
  if (!error) {
  //处理你的验证结果
  NSLog(@"\nsession ID: %@,\ndata: %@", [manager getCookieValue:@"msid"], [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding]);
  //成功请调用decisionHandler(GT3SecondaryCaptchaPolicyAllow)
  decisionHandler(GT3SecondaryCaptchaPolicyAllow);
  //失败请调用decisionHandler(GT3SecondaryCaptchaPolicyForbidden)
  //decisionHandler(GT3SecondaryCaptchaPolicyForbidden);
  }
  else {
  //二次验证发生错误
  decisionHandler(GT3SecondaryCaptchaPolicyForbidden);
  NSLog(@"validate error: %ld, %@", (long)error.code, error.localizedDescription);
  }
  }

希望能有Swift版本，并添加Carthage的支持

极验怎么跳过验证，直接调用业务的API2接口

假如我使用Api2去登录，然后根据登录返回的数据修改参数，修改完再次登录，这样的话就需要调用两次极验验证，能不能第二次不进行极验验证，直接调用API2的登录接口？

用到了IDFA，为什么不提示一下？！

起码README文档中要提一下吧？

支持bitcode的Framework编译报错，说不支持bitcode,能重新编译下吗？

ld: bitcode bundle could not be generated because 
'/Users/aa/GTFramework/GT3Captcha.framework/GT3Captcha(GT3APIService.o)' 
was built without full bitcode

Archive方式