前言:
各位同学大家好 ,有一段时间没有见面了。 具体多久我也不清楚了, 最近在学习iOS 手游sdk 的开发 所以就想着写完 写一份教程分享给大家, 本人之前一直都是做安卓开发的 安卓 app和安卓手游SDK 开的都会。
需要用到的三方库
pod 'AFNetworking'pod 'SDWebImage','4.0.0'pod 'WHToast','~>0.1.0'
效果图
主要实现逻辑 手游SDK
初始化 init.
登录 login
支付 pay.
区服登录 servicelogin.
等级变化上报 updateuserinfo
接口设计
//
// NineFunSdk.h
// 016登录界面
//
// Created by xuqing on 2022/4/26.
//#import <Foundation/Foundation.h>
#import <UIkit/UIkit.h>
#import "RoleInfo.h"
#import "ServiceInfo.h"
NS_ASSUME_NONNULL_BEGINtypedef void (^LoginFinishBlock)(BOOL success, id data);typedef void (^InitFinishBlock)(BOOL success, NSString * data);
typedef void (^PayFinishBlock)(BOOL success, NSString * data);typedef void (^ServiceBlock)(BOOL success);typedef void (^UpdateUserInfoBlcok)(BOOL success);@interface NineFunSdk : NSObject+ (void)viewcontroller:(UIViewController *)controller sdkCheckLogin:(LoginFinishBlock)finishBlock;+ (void)initSdk:(InitFinishBlock)finishBlock;+ (void)pay:(PayFinishBlock)finishBlock;+ (void)serviceinfo:(ServiceInfo*)getserviceinfo serviceLogin:(ServiceBlock)finishBlock;+ (void)roleinfo:(RoleInfo*)getroleinfo updateUserInfo:(UpdateUserInfoBlcok)finishBlock;@endNS_ASSUME_NONNULL_END
我们定义这些对外方法 当然你也可以写成类方法 然后写个单例 去掉也行 我这边方便就用 + 然后每个方法我们定义了 block回调 这个看具体需求 因为参考了安卓了那边写法 每个对外接口都给回调 我就都给加了
具体接口的实现
//
// NineFunSdk.m
//
// Created by xuqing on 2022/4/26.
//#import "NineFunSdk.h"
#import "ViewController.h"
#import <AFNetworking.h>
#import "NSString+Encrypt.h"
#import "RoleInfo.h"
#import "ServiceInfo.h"
#import "Md5Utils.h"@implementation NineFunSdk// 登录接口
+ (void)viewcontroller:(UIViewController *)controller sdkCheckLogin:(LoginFinishBlock)finishBlock{ViewController * viewController= [[ViewController alloc]init];viewController.logBlock = finishBlock;[controller presentViewController:viewController animated:YES completion:nil];
}// 初始化接口
+ (void)initSdk:(InitFinishBlock)finishBlock{}//支付接口
+ (void)pay:(PayFinishBlock)finishBlock{}// 区服登录接口
+ (void)serviceinfo:(ServiceInfo*)getserviceinfo serviceLogin:(ServiceBlock)finishBlock{NSLog(@"区服登录");NSString * sign = [NSString stringWithFormat:@"sid=%@role_id=%@role_anme=%@||0a649d6b-df9f-4583-bf7d-3fae84838519",getserviceinfo->_sid,getserviceinfo->_roleid,getserviceinfo->_rolename];NSLog(@" sign %@", sign);// NSString * getsign=[sign MD5];NSString * getsign=[Md5Utils getMd5_32Bit_String:sign isUppercase:NO];NSString * serviceLoginUrl=@"http://192.168.7.25:8090/boss/serviceinfo/servicelogin?";NSMutableString *geturl = [NSMutableString string];[geturl appendString:serviceLoginUrl];[geturl appendString:@"gid="];[geturl appendString:getserviceinfo->_gid];[geturl appendString:@"&"];[geturl appendString:@"sid="];[geturl appendString:getserviceinfo->_sid];[geturl appendString:@"&"];[geturl appendString:@"role_name="];[geturl appendString:getserviceinfo->_rolename];[geturl appendString:@"&"];[geturl appendString:@"role_level="];[geturl appendString:getserviceinfo->_rolelevel];[geturl appendString:@"&"];[geturl appendString:@"role_id="];[geturl appendString:getserviceinfo->_roleid];[geturl appendString:@"&"];[geturl appendString:@"sign="];[geturl appendString:getsign];NSString *url = [geturl stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];// NSLog(@"geturl --- %@",geturl);[[AFHTTPSessionManager manager]GET:url parameters:nil headers:nil progress:^(NSProgress * _Nonnull downloadProgress) {NSLog(@"");} success:^(NSURLSessionDataTask * _Nonnull task, id _Nullable responseObject) {NSLog(@"");NSLog(@"请求成功---%@",responseObject);NSLog(@"请求 msg ---%@",[responseObject objectForKey:(@"msg")]);finishBlock(YES);} failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {NSLog(@"");}];};//等级变化上报接口
+ (void)roleinfo:(RoleInfo*)getroleinfo updateUserInfo:(UpdateUserInfoBlcok)finishBlock{NSLog(@"等级变化上报");NSString * sign = [NSString stringWithFormat:@"sid=%@role_id=%@role_anme=%@||0a649d6b-df9f-4583-bf7d-3fae84838519",getroleinfo->_sid,getroleinfo->_roleid,getroleinfo->_rolename];NSLog(@" sign %@", sign);// NSString * getsign=[sign MD5];NSString * getsign=[Md5Utils getMd5_32Bit_String:sign isUppercase:NO];NSLog(@" getsign %@", getsign);NSString * serviceLoginUrl=@"http://192.168.7.25:8090/boss/roleinfo/submitroleinfo?";NSMutableString *geturl = [NSMutableString string];[geturl appendString:serviceLoginUrl];[geturl appendString:@"gid="];[geturl appendString:getroleinfo->_gid];[geturl appendString:@"&"];[geturl appendString:@"sid="];[geturl appendString:getroleinfo->_sid];[geturl appendString:@"&"];[geturl appendString:@"role_name="];[geturl appendString:getroleinfo->_rolename];[geturl appendString:@"&"];[geturl appendString:@"role_level="];[geturl appendString:getroleinfo->_rolelevel];[geturl appendString:@"&"];[geturl appendString:@"role_id="];[geturl appendString:getroleinfo->_roleid];[geturl appendString:@"&"];[geturl appendString:@"sign="];[geturl appendString:getsign];NSString *url = [geturl stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];// NSLog(@"geturl --- %@",geturl);[[AFHTTPSessionManager manager]GET:url parameters:nil headers:nil progress:^(NSProgress * _Nonnull downloadProgress) {NSLog(@"");} success:^(NSURLSessionDataTask * _Nonnull task, id _Nullable responseObject) {NSLog(@"");NSLog(@"请求成功---%@",responseObject);NSLog(@"请求 msg ---%@",[responseObject objectForKey:(@"msg")]);finishBlock(YES);} failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {NSLog(@"");}];}
@end
因为时间问题 我这边制作了 login 和servicelogin. updateuserinfo 这几个接口的实现
登录接口
// 登录接口
+ (void)viewcontroller:(UIViewController *)controller sdkCheckLogin:(LoginFinishBlock)finishBlock{ViewController * viewController= [[ViewController alloc]init];viewController.logBlock = finishBlock;[controller presentViewController:viewController animated:YES completion:nil];
}
登录接口我们需要传入 UIViewController 实例和 实现LoginFinishBlock 回调
登录界面逻辑
//
// ViewController.h
// 016登录界面
//
// Created by xuqing on 2021/7/27.
//#import <UIKit/UIKit.h>@interface ViewController : UIViewController{//登录界面的组成UILabel *_usernameLabel;UILabel * _passwordLabel;UITextField *_userTextfield;UITextField *_passwordfield;UIButton * _loginBtn;UIButton * _registerBtn;}
@property(retain,nonatomic)UILabel * usernameLabel;
@property(retain,nonatomic)UILabel * pswLabel;
@property(retain,nonatomic)UITextField * userTextfield;
@property(retain,nonatomic)UITextField * pswfield;
@property(retain,nonatomic)UIButton * loginBtn ;
@property(retain, nonatomic)UIButton * registerBtn;
@property (nonatomic,copy)void(^logBlock)(BOOL success, id data);
@end
//
// ViewController.m
// 016登录界面
//
// Created by xuqing on 2021/7/27.
#import "ViewController.h"
#import "RegisterController.h"
#import <AFNetworking.h>
#import <WHToast.h>
#import "TextUtils.h"
@interface ViewController ()
@end@implementation ViewController
@synthesize usernameLabel=_usernameLabel;
@synthesize pswLabel=_passwordLabel;
@synthesize userTextfield=_userTextfield;
@synthesize pswfield=_passwordfield;
@synthesize loginBtn=_loginBtn;
@synthesize registerBtn=_registerBtn;- (void)viewDidLoad {[super viewDidLoad];_usernameLabel =[[UILabel alloc]init];_usernameLabel.frame=CGRectMake(60, 100, 60, 40);_usernameLabel.text=@"账号:";_usernameLabel.textColor=[UIColor blueColor];[self.view addSubview:_usernameLabel];_userTextfield =[[UITextField alloc] init];_userTextfield.frame=CGRectMake(100, 100,180, 40);_userTextfield.font= [UIFont systemFontOfSize:15];// 设置字体颜色_userTextfield.textColor=[UIColor blackColor];//设置边框的风格// UITextBorderStyleBezel bezel线框// UITextBorderStyleRoundedRect 圆角风格// UITextBorderStyleLine 线框风格// UITextBorderStyleNone 无边框风格_userTextfield.borderStyle= UITextBorderStyleRoundedRect;//设置虚拟键盘风格//UIKeyboardTypeDefault 默认风格//UIKeyboardTypeNumberPad 纯数字风格//UIKeyboardTypeNamePhonePad 字母和数字组合风格_userTextfield.keyboardType=UIKeyboardTypeNamePhonePad;_userTextfield.placeholder=@"请输入用户名...";//是否作为密码输入//YES 做为处理 圆点加密//NO: 正常显示输入的文字_userTextfield.secureTextEntry= NO;[self.view addSubview: _userTextfield];_passwordLabel =[[UILabel alloc]init];_passwordLabel.frame=CGRectMake(60, 150, 60, 40);_passwordLabel.text=@"密码:";_passwordLabel.textColor=[UIColor blueColor];[self.view addSubview:_passwordLabel];_passwordfield =[[UITextField alloc] init];_passwordfield.frame=CGRectMake(100, 150,180, 40);_passwordfield.font= [UIFont systemFontOfSize:15];// 设置字体颜色_passwordfield.textColor=[UIColor blackColor];//设置边框的风格// UITextBorderStyleBezel bezel线框// UITextBorderStyleRoundedRect 圆角风格// UITextBorderStyleLine 线框风格// UITextBorderStyleNone 无边框风格_passwordfield.borderStyle= UITextBorderStyleRoundedRect;//设置虚拟键盘风格//UIKeyboardTypeDefault 默认风格//UIKeyboardTypeNumberPad 纯数字风格//UIKeyboardTypeNamePhonePad 字母和数字组合风格_passwordfield.keyboardType=UIKeyboardTypeNamePhonePad;_passwordfield.placeholder=@"请输入密码...";//是否作为密码输入//YES 做为处理 圆点加密//NO: 正常显示输入的文字_passwordfield.secureTextEntry= YES;[self.view addSubview: _passwordfield];_loginBtn=[UIButton buttonWithType: UIButtonTypeRoundedRect];_loginBtn.frame=CGRectMake(80, 220, 80, 40);[_loginBtn setTitle:@"登录" forState:UIControlStateNormal];[_loginBtn addTarget:self action:@selector(login) forControlEvents:UIControlEventTouchUpInside];_loginBtn.backgroundColor=[UIColor blueColor];[_loginBtn setTitleColor: [UIColor whiteColor ] forState:UIControlStateNormal] ;//设置按钮颜色[_loginBtn setTitleColor: [UIColor grayColor] forState:UIControlStateHighlighted] ;[self.view addSubview:_loginBtn];_registerBtn=[UIButton buttonWithType:UIButtonTypeRoundedRect];_registerBtn.frame=CGRectMake(180, 220, 80, 40);[_registerBtn setTitle:@"注册" forState:UIControlStateNormal];[_registerBtn addTarget:self action:@selector(registerMethod) forControlEvents:UIControlEventTouchUpInside];_registerBtn.backgroundColor=[UIColor blueColor];[_registerBtn setTitleColor:[UIColor whiteColor] forState:UIControlStateNormal];[self.view addSubview:_registerBtn];}-(void)registerMethod{RegisterController * registerController= [[RegisterController alloc]init];registerController.registerBlock = self.logBlock;[self presentViewController:registerController animated:YES completion:nil];}-(void)login{NSString * _strTextName=_userTextfield.text;NSString * _strTextPsw=_passwordfield.text;if(![TextUtils isBlankString:_strTextName]&&![TextUtils isBlankString:_strTextPsw]){NSLog(@"登录成功");NSLog(@"%@ %@",_strTextName,_strTextPsw);NSString * registerString=@"http://192.168.7.25:8090/boss/user/validlogin?";NSString * str1=@"username=";NSString * str2=@"password=";NSMutableString *geturl = [NSMutableString string];[geturl appendString:registerString];[geturl appendString:str1];[geturl appendString:_strTextName];[geturl appendString:@"&"];[geturl appendString:str2];[geturl appendString:_strTextPsw];NSLog(@" geturl --- > %@",geturl);[[AFHTTPSessionManager manager]GET:geturl parameters:nil headers:nil progress:^(NSProgress * _Nonnull downloadProgress) {NSLog(@"");} success:^(NSURLSessionDataTask * _Nonnull task, id _Nullable responseObject) {NSLog(@"");NSLog(@"请求成功---%@",responseObject);NSLog(@"请求 msg ---%@",[responseObject objectForKey:(@"msg")]);if (self.logBlock) {self.logBlock(YES, responseObject);}[self dismissViewControllerAnimated:YES completion:nil];} failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {NSLog(@"");}];}else {[WHToast showMessage:@"账号或者密码不能为空" duration:2 finishHandler:^{NSLog(@"登录toast");}];}}- (void)touchesBegan:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event{//回收键盘[_userTextfield resignFirstResponder];[_passwordfield resignFirstResponder];
}
@end
我们看到 我们在登录的viewcontroller 也定义了一个block 然后我们跳转的时候将外部传进来的 block 赋值给我们在登录定义的block.然后我们在登录网络请求成功以后 回调我们数据回去即可。
还有注册的viewcontroller 也是同理的 我就不展开讲了 也是注册成功 将服务端返回的数据结构 回调回去
数据上报逻辑 servicelogin
// 区服登录接口
+ (void)serviceinfo:(ServiceInfo*)getserviceinfo serviceLogin:(ServiceBlock)finishBlock{NSLog(@"区服登录");NSString * sign = [NSString stringWithFormat:@"sid=%@role_id=%@role_anme=%@||0a649d6b-df9f-4583-bf7d-3fae84838519",getserviceinfo->_sid,getserviceinfo->_roleid,getserviceinfo->_rolename];NSLog(@" sign %@", sign);NSString * getsign=[Md5Utils getMd5_32Bit_String:sign isUppercase:NO];NSLog(@" getsign --- > %@" ,getsign);NSString * serviceLoginUrl=@"http://192.168.7.25:8090/boss/serviceinfo/servicelogin?";NSMutableString *geturl = [NSMutableString string];[geturl appendString:serviceLoginUrl];[geturl appendString:@"gid="];[geturl appendString:getserviceinfo->_gid];[geturl appendString:@"&"];[geturl appendString:@"sid="];[geturl appendString:getserviceinfo->_sid];[geturl appendString:@"&"];[geturl appendString:@"role_name="];[geturl appendString:getserviceinfo->_rolename];[geturl appendString:@"&"];[geturl appendString:@"role_level="];[geturl appendString:getserviceinfo->_rolelevel];[geturl appendString:@"&"];[geturl appendString:@"role_id="];[geturl appendString:getserviceinfo->_roleid];[geturl appendString:@"&"];[geturl appendString:@"sign="];[geturl appendString:getsign];NSString *url = [geturl stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
// NSLog(@"geturl --- %@",geturl);[[AFHTTPSessionManager manager]GET:url parameters:nil headers:nil progress:^(NSProgress * _Nonnull downloadProgress) {NSLog(@"");} success:^(NSURLSessionDataTask * _Nonnull task, id _Nullable responseObject) {NSLog(@"");NSLog(@"请求成功---%@",responseObject);NSLog(@"请求 msg ---%@",[responseObject objectForKey:(@"msg")]);finishBlock(YES);} failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {NSLog(@"");}];
};
我们同样定义对外接口方法 需要传入 ServiceInfo 模型实例 然后实现 ServiceBlock 回调
然后我们在这个方法内部去请求服务端进去游戏里面数据上报逻辑 。
具体接入效果
//登录
- (IBAction)login:(id)sender {[NineFunSdk viewcontroller:self sdkCheckLogin:^(BOOL success, id data) {NSLog(@"回调成功成功---%@",data);}];
}
// 区服登录上报
- (IBAction)servicelogin:(id)sender {ServiceInfo * serviceinfo=[ServiceInfo new];serviceinfo->_sid=@"1111";serviceinfo->_gid=@"424251";serviceinfo->_roleid=@"旋涡名人";serviceinfo->_rolename=@"最强王者";serviceinfo->_rolelevel=@"214141";[NineFunSdk serviceinfo:serviceinfo serviceLogin:^(BOOL success) {NSLog(@"区服登录");}];
}
// 等级变化上报
- (IBAction)updateuserinfo:(id)sender {RoleInfo * roleinfo= [RoleInfo new];roleinfo->_gid=@"12232";roleinfo->_roleid=@"422422";roleinfo->_rolename=@"醉生梦死";roleinfo->_sid=@"测试服务器";roleinfo->_rolelevel=@"191";[NineFunSdk roleinfo:roleinfo updateUserInfo:^(BOOL success) {NSLog(@"等级变化上报");}];
}
整个iOS 手机SDK 大概就讲完了
最后总结:
有很多同学这时候就说 做成SDK 应该最后要打包成静态库才对吧 。是的没错 这一期我只是讲大概思路 因为我也不会打包静态库 所以我也还在学习 后面继续更新哈代码里面很多的三方库其实也不是这样去用的 我们应该直接去拉代码 不应该用 pod file 这样去依赖 我也是为了方便。最后希望我的文章能帮助到各位解决问题 ,以后我还会贡献更多有用的代码分享给大家。各位同学如果觉得文章还不错 ,麻烦给关注和star,小弟在这里谢过啦!
、