帮助与文档

> >

>SMSSDK-iOS 2.0.0 免费短信升级须知

一、获取短信SDK

点击下载最新版SDK,解压后得到以下文件结构:

8D68B2EF-985B-4B13-8DAE-11E40E0D06C2

1、SMS_SDK:短信验证码SDK,包括静态库和本地化文件。无UI使用时直接将这个文件夹拖入工程。

2、SMS_SDKDemo:示例Demo 。

3、如果想要集成SMSSDK 提供的UI,需要把SMS_SDK,SMSSDKUI.xcodeproj以及SMSSDKUI.bundle3个拖进项目里,意思就是把SMSSDKUI作为一个项目集成进去,然后build出来一个.a包,把.a包加进库资源文件里。

二、导入SDK

将SMS_SDK,SMS_SDK,SMSSDKUI.xcodeproj以及SMSSDKUI.bundle这个文件夹拖入工程。步骤如下:

1D2CDCC9-BC6E-4264-9431-25CBFAEFD3ED

 

CF5A4FB6-9B9A-4242-BF98-19280A66D6F1

三、添加依赖库文件

必要:
  • libz.dylib
  • libicucore.dylib
  • MessageUI.framework
  • JavaScriptCore.framework
  • libstdc++.dylib
  • 注意XCode7上运行报错的话,需要添加这些依赖库
  • SystemConfiguration.framework
  • CoreTelephony.framework
  • AdSupport.framework
可选:
  • AddressBook.framework (通讯录功能需要)
  • AddressBookUI.framework(通讯录功能需要)

SMSSDKAddFramework

四、添加初始化代码

1、在appDelegate 添加

   #import <SMS_SDK/SMSSDK.h>

2 、在

  - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions

添加

   //初始化应用,appKey和appSecret从后台申请得
   [SMSSDK registerApp:appKey
            withSecret:appSecret];

appKey 和 appSecret的获取:

(1)到Mob官网注册成为Mob开发者;

(2)到应用管理后台新建应用。新建应用步骤,请参考:网址

五、使用SDK提供的API

短信代码

SMSSDK.h文件为SMSSDK的核心类。这个类的所有方法以类方法提供,根据需要直接使用相应的方法。

短信UI部分是以Demo形式开源的,具体参考Demo。以下是Demo中部分UI模块的说明:

1、弹出注册页面

#import "SMSSDKUI.h"
//展示获取验证码界面,SMSGetCodeMethodSMS:表示通过文本短信方式获取验证码
    [SMSSDKUI showVerificationCodeViewWithMetohd:SMSGetCodeMethodSMS result:^(enum SMSUIResponseState state,NSString *phoneNumber,NSString *zone, NSError *error) {

    }];

注册界面RegViewController,进入该界面后,可选择国家和地区和输入手机号码进行短信注册验证;

选择国家和地区的选项进入SectionsViewController,在该控制器会从服务端获取所支持的国家和地区;

用户在注册页面输入手机号码之后,点击下一步,界面跳转到短信验证界面同时服务端会发送短信验证码到手机;

短信验证界面对应的控制器为VerifyViewController 主要处理短信的验证功能。

2、弹出通讯录好友界面

#import "YJLocalCountryData.h"
#import <SMS_SDK/Extend/SMSSDK+AddressBookMethods.h>
#import <AddressBook/AddressBook.h>
 [_testView setNumber:0];

    NSString *filePath = [[NSBundle mainBundle] pathForResource:@"SMSSDKUI" ofType:@"bundle"];
    NSBundle *bundle = [[NSBundle alloc] initWithPath:filePath];
    [YJLocalCountryData showMessag:NSLocalizedStringFromTableInBundle(@"loading", @"Localizable", bundle, nil) toView:self.view];

    [SMSSDK getAllContactFriends:^(NSError *error, NSArray *friendsArray) {

        if (!error)
        {
            [SMSSDKUI showGetContactsFriendsViewWithNewFriends:[NSMutableArray arrayWithArray:friendsArray] newFriendClock:_friendsBlock result:^{

            }];
        }
        else
        {
            NSString *messageStr = [NSString stringWithFormat:@"%zidescription",error.code];
            UIAlertView* alert = [[UIAlertView alloc] initWithTitle:NSLocalizedStringFromTableInBundle(@"codesenderrtitle", @"Localizable", bundle, nil)
                                                            message:NSLocalizedStringFromTableInBundle(messageStr, @"Localizable", bundle, nil)
                                                           delegate:self
                                                  cancelButtonTitle:NSLocalizedStringFromTableInBundle(@"sure", @"Localizable", bundle, nil)
                                                  otherButtonTitles:nil, nil];
            [alert show];

        }

    }];

    if(ABAddressBookGetAuthorizationStatus() != kABAuthorizationStatusAuthorized)
    {
        NSString* str = [NSString stringWithFormat:NSLocalizedStringFromTableInBundle(@"authorizedcontact", @"Localizable", bundle, nil)];
        UIAlertView* alert = [[UIAlertView alloc] initWithTitle:NSLocalizedStringFromTableInBundle(@"notice", @"Localizable", bundle, nil)
                                                        message:str
                                                       delegate:self
                                              cancelButtonTitle:NSLocalizedStringFromTableInBundle(@"sure", @"Localizable", bundle, nil)
                                              otherButtonTitles:nil, nil];
        [alert show];
    }

通讯录好友界面SectionsViewControllerFriends,在事件响应中弹出该好友控制器即可;进入该界面后 会把通讯录的好友分为两类:

  • 已加入的用户:可以点击添加按钮,直接添加已加入该app的通讯录好友。
  • 待邀请的用户:可以点击邀请按钮发送短信邀请好友加入该app。