Flutter 插件开发-接入京东SDK唤醒(ios篇)

Flutter 插件开发-实战京东SDK唤醒(ios)

本项目基于Flutter版本1.12开发，功能是flutter可以通过京东的sdk唤醒京东app打开商品的详情。项目中的appkey需要自己申请，在这文章主要记录本人学习写插件的过程。

项目地址

https://github.com/selfimgr/flutter_jdsdk 喜欢的话就点个赞,star一下吧~

总体的效果如下所示：

在这里插入图片描述

创建插件工程

1. 通过Android stuido 工具来创建插件工程，其他方式可以用命令来创建。

   
   
   

   在这里插入图片描述
   
   

   写上包名就可以，这里默认不选，指的是插件以java和oc的实现。下一步等待创建完成。

   
   
   

   在这里插入图片描述
   
   创建后的工程目录
   
   

   在这里插入图片描述
   
   

   lib:插件flutter调用原生的代码
   android: 实现Android的插件代码
   ios: 实现ios的插件代码
   example: 默认示例的代码

编译和运行ios插件示例

这里先把创建的插件工程编译和运行起来，因为ios有些坑需要记录下。不像android那样直接跑就行了。

1. 首先需要在example工程下的ios目录，执行futter build ios,主要是需要pod install，生成xxx.workspace的一些配置

flutter build ios

2. 运行xcode ，报错Building for iOS, but the linked and embedded framework 'App.framework'，如果你能顺利跑起来，无视接下来的解决方案，跳过就此小节。
3. 回到项目的根目录，执行flutter clean

flutter clean

4. 然后删除ios/Flutter/App.framework

rm -rf ios/Flutter/App.framework

再次运行xcode就可以了。

编写flutter的插件调用代码

打开lib目录，默认有一个官方提供的方法是调用原生代码获取版本号的功能。本项目有两个功能，一个是京东sdk的初始化，一个是通过京东商品的url唤醒京东app的商品详情页。

import 'dart:async';

import 'package:flutter/foundation.dart';
import 'package:flutter/services.dart';

class Jdsdk {
  static const MethodChannel _channel =
      const MethodChannel('jdsdk');

  static Future get platformVersion async {
    final String version = await _channel.invokeMethod('getPlatformVersion');
    return version;
  }

  ///初始化sdk
  static Future init({@required String appKey, @required String appSecret}) async {
    final String version = await _channel.invokeMethod('init',{"appKey": appKey, "appSecret": appSecret});
    return version;
  }

  ///打开京东任意url
  static Future openUrl({@required String url}) async {
    final String version = await _channel.invokeMethod('openUrl',{"url": url});
    return version;
  }
}

导入SDK的Bundler和Framework

这里演示ios端添加京东sdk的几个步骤

1. sdk的内容有两个，一个bundle，一个Framework

   
   
   

   在这里插入图片描述

2. 打开xcode工程,通过下面的方式打开，还可以使用example目录下的ios目录打开也一样

   
   
   

   在这里插入图片描述

3. JDSDK.bundle的添加，这里选择了copy item和Create groups。这个bundle下面只有一张safe.jpg的安全图片，需要到京东官方后天管理去下载生成才可以用。

   
   
   在这里插入图片描述
   
   

   4.Framework的添加

新建Framework文件夹，并将SDK的framework拉入该文件夹下。

在这里插入图片描述

回到xcode工程，添加刚刚framework，弹框不用选择copy。

在这里插入图片描述

添加几个系统的库，这是接入文档要求的。

在这里插入图片描述

最后在插件podspec文件，添加如下代码，终端进入example下ios目录执行pod install

  s.vendored_frameworks = 'Framework/*.framework'

开发ios原生的实现接口

目录有点深，看图

在这里插入图片描述

JdsdkPlugin.m就是要实现的原生代码，handleMethodCall就是dart调用的函数。直接上代码，init 和openUrl就是上面lib目录定义的接口参数要一致，不然调用不到。

- (void)handleMethodCall:(FlutterMethodCall*)call result:(FlutterResult)result {
  if ([@"getPlatformVersion" isEqualToString:call.method]) {
    result([@"iOS " stringByAppendingString:[[UIDevice currentDevice] systemVersion]]);
  } else if ([@"init" isEqualToString:call.method]) {
      NSLog(@"init flutter");
    //初始化sdk具体实现
      NSString *appKey = call.arguments[@"appKey"];
    NSString *appSecret = call.arguments[@"appSecret"];
    NSLog (@"appKey is :%@", appKey);
    NSLog (@"appSecret is :%@", appSecret);
    [[KeplerApiManager sharedKPService]asyncInitSdk:appKey secretKey:appSecret sucessCallback:^(){
        NSLog (@"success");
        result(@"{status:1}");
    }failedCallback:^(NSError *error){
        NSLog (@"fail");
       result(@"{status:0}");
    }];
  }else if ([@"openUrl" isEqualToString:call.method]) {
      //打开京东任意url
      NSString *url = call.arguments[@"url"];
         if ([[UIApplication sharedApplication]canOpenURL:[NSURL URLWithString:[NSString stringWithFormat:@"openapp.jdmobile://"]]]) {//判断是否安装京东app
       [ [KeplerApiManager sharedKPService]openKeplerPageWithURL:url userInfo:nil successCallback:^{
             NSLog (@"success");
                  result(@"{status:1}");
        } failedCallback:^(NSInteger code, NSString * _Nonnull url) {
                    NSLog (@"fail");
                  result(@"{status:0}");
        }];
    }else{
            result(@"{status:0}");
    }
  }else {
    result(FlutterMethodNotImplemented);
  }
}

具体如何使用？

pub仓库地址 https://pub.flutter-io.cn/packages/jdsdk/install