JMLink-React-Native

ChangeLog

v 1.2.0

极光魔链RN 1.2.4

v 1.0.0

极光魔链RN第一版

1. 安装

npm install jmlink-react-native --save

• 注意：如果项目里没有jcore-react-native，需要安装

  npm install jcore-react-native --save
  

2. 配置

2.1 Android

• build.gradle

  android {
        defaultConfig {
            applicationId "yourApplicationId"           //在此替换你的应用包名
            ...
            manifestPlaceholders = [
                    JPUSH_APPKEY: "yourAppKey",         //在此替换你的APPKey
                    JPUSH_CHANNEL: "yourChannel",       //在此替换你的channel
                    JMLINK_SCHEME: "yourScheme"  // 在此替换你的scheme
            ]
        }
    }
  

  dependencies {
        ...
        implementation project(':jmlink-react-native') // 添加 jverification 依赖
        implementation project(':jcore-react-native')         // 添加 jcore 依赖
    }
  

• setting.gradle

  include ':jmlink-react-native'
  project(':jmlink-react-native').projectDir = new File(rootProject.projectDir, '../node_modules/jmlink-react-native/android')
  include ':jcore-react-native'
  project(':jcore-react-native').projectDir = new File(rootProject.projectDir, '../node_modules/jcore-react-native/android')
  

2.2 iOS

2.2.1 pod

pod install

• 注意：如果项目里使用pod安装过，请先执行命令

  pod deintegrate
  

2.2.2 手动方式

• Libraries

  Add Files to "your project name"
  node_modules/jcore-react-native/ios/RCTJCoreModule.xcodeproj
  node_modules/jmlink-react-native/ios/RCTJMLinkModule.xcodeproj
  

• Build Settings

  All --- Search Paths --- Header Search Paths --- +
  $(SRCROOT)/../node_modules/jcore-react-native/ios/RCTJCoreModule/
  $(SRCROOT)/../node_modules/jmlink-react-native/ios/RCTJMLinkModule/
  

• Build Phases

  libz.tbd
  libc++.1.tbd
  libresolv.tbd
  libsqlite3.tbd
  libRCTJCoreModule.a
  libRCTJMLinkModule.a
  

• info.plist

  View controller-based status bar appearance : YES
  

2.2.3 配置

• 配置App的URL Scheme

iOS系统中App之间是相互隔离的，通过URL Scheme，App之间可以相互调用，并且可以传递参数。 选中Target->Info->URL Types，配置URL Scheme（比如：jmlink）

在Safari中输入URL Scheme://（比如：jmlink://）如果可以唤起App，说明该URL Scheme配置成功。

• 配置Universal link

Universal link是iOS9的一个新特性，通过Universal link，App可以无需打开Safari，直接从微信等应用中跳转到App，真正的实现一键直达。如果使用URL Scheme的话，需要先打开Safari，用户体验变得很差，如果App未安装，还会出现以下错误对话框

Xcode 里的具体配置请查看 mLink的设置

• 初始化代码

  在 iOS 项目的 AppDelegate.m 文件内的 [application: didFinishLaunchingWithOptions:] 方法里必须调用如下代码完成初始化

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
 {  
  	[RCTJMLinkModule setupAppKey:@"极光官网分配的appKey"
                       channel:@"channel"
                 advertisingId:nil
                  isProduction:NO
                       isDebug:YES]; 
  }

3. 引用

参考：App.js

4. API

详见：index.js

5. 其他

• 集成前务必将example工程跑通
• 上报问题还麻烦先将init参数中params的debug字段设置成true，拿到debug日志