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

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

项目地址

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

总体的效果如下所示:

flutter真机运行 ios flutter开发ios_移动开发

创建插件工程

  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
  1. 运行xcode ,报错Building for iOS, but the linked and embedded framework ‘App.framework’,如果你能顺利跑起来,无视接下来的解决方案,跳过就此小节。
  2. 回到项目的根目录,执行flutter clean
flutter clean
  1. 然后删除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<String> get platformVersion async {
    final String version = await _channel.invokeMethod('getPlatformVersion');
    return version;
  }

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

  ///打开京东任意url
  static Future<String> 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拉入该文件夹下。

flutter真机运行 ios flutter开发ios_移动开发_02


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

flutter真机运行 ios flutter开发ios_ios_03


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

flutter真机运行 ios flutter开发ios_flutter真机运行 ios_04


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

s.vendored_frameworks = 'Framework/*.framework'

开发ios原生的实现接口

目录有点深,看图

flutter真机运行 ios flutter开发ios_移动开发_05


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