OpenApplus
官方网站
捐赠热线如果您想要进行捐赠,并希望与我联系,请在付款备注中留下您的微信联系方式,以便我添加您。
参考链接
http://www.jianshu.com/p/9c289f784928
iOS集成
Cocoapods 安装
推荐使用 CocoaPods 的方式安装使用。
CocoaPods 是一个广泛适用于Objective-C依赖管理工具,能够自动配置项目,简化你配置Openapp+的过程,使用以下命令行安装
$ gem install cocoapods
OpenApplus 安装
使用CocosPods集成Openapp+到Xcode,需要编写/podspec/OpenApplus.podspec文件
Pod::Spec.new do |s|
s.name = "OpenApplus"
s.version = "1.0.1"
s.summary = "OpenApplus framework"
s.homepage = "http://github.com/linwaiwai/openapplus"
s.license = { :type => 'OpenApplus License, Version 1.0.0', :text => <<-LICENSE
Licensed under the OpenApplus License, Version 1.0.0 (the "License");
you may not use this file except in compliance with the License.
LICENSE
}
s.author = "linwaiwai"
s.platform = :ios, "6.0.0"
s.source = { :git => "https://github.com/linwaiwai/openapplus.git", :tag => "1.0.1"}
s.frameworks = "UIKit"
s.requires_arc = true
s.dependency 'SDWebImage', '3.7.5'
s.dependency 'SSZipArchive', '1.6.2'
s.dependency 'SVProgressHUD', '2.1.2'
s.dependency 'UMengUShare/Social/WeChat', '6.3.0'
s.dependency 'MJRefresh', '3.1.12'
s.dependency 'AFNetworking'
s.dependency 'OpenUDID'
s.subspec 'OpenApplus' do |ss|
ss.vendored_frameworks = '*.framework'
ss.vendored_libraries = '*.a'
ss.source_files = '*.h'
ss.resource = '*.bundle'
end
end
在Podfile文件中加入
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '8.0'
#忽略引入库的警告
inhibit_all_warnings!
target 'openapplus-ios-demo' do
pod 'OpenApplus', :podspec => './podspec/OpenApplus.podspec'
end
在工程中的Info.plist文件中添加如下项
<key>NSAppTransportSecurity</key>
<dict>
<key>NSAllowsArbitraryLoads</key>
<true/>
</dict>
运行
在 AppDelegate.m 里按顺序调用三个方法:
1、调用 +startWithAppKey: ,参数为第一步获得的 AppKey。
2、调用 +sync 方法检查包更新。
在AppDelegate.m或ViewController.m中调用 navigateToMiniProgram: 加载小程序项目,参数为在平台中创建的项目的名称。
#import <"openapplus/openapplus.h">
@implementation AppDelegate
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
UINavigationController *navigationController = [[UINavigationController alloc] initWithRootViewController:testViewController];
self.window.rootViewController = navigationController;
[self.window makeKeyAndVisible];
[OpenApplus startWithAppKey:@"test"];
[OpenApplus sync];
[OpenApplus setNavigationController:navigationController];
// JS_APPID 为小程序的APP_ID
[OpenApplus navigateToMiniProgram:@"openapplus://jsApp/#JS_APPID#" completion:^{
}];
...
}
@end
上述例子是把 Openapplus 同步放在 -application:didFinishLaunchingWithOptions: 里,若希望包能及时推送,可以把 [OpenApplus sync] 放在 -applicationDidBecomeActive: 里,每次唤醒都能同步更新 OpenApplus 包,不需要等用户下次启动。
Android集成
Android Studio集成
下载SDK功能组件,解压.zip文件以获取相应组件包(openapplus-release.aar),在Android Studio的项目工程的libs目录中复制相应的组件jar包。 右键点击Android Studio的项目工程,选择打开模块设置 —> 在项目结构弹出窗口中,选择依赖项选项卡 —> 点击左下角的“+”,选择组件包类型 —> 引入相应的组件包。
或者使用gradle
buildscript {
repositories {
jcenter()
}
}
allprojects {
repositories {
jcenter()
}
}
dependencies{
implementation ('com.openapplus:openapplus:1.0.3')
implementation 'com.eclipsesource.j2v8:j2v8:6.1.0@aar'
}
详细添加位置请参考DEMO[https://github.com/linwaiwai/openapplus-demo/blob/master/Android/]
运行
在项目工程的自定义application中的onCreate方法中添加以下两个方法: 注意:一定要在主进程进行该项操作
OpenApplus.registerApp(this, SampleContants.APPID, SampleContants.APP_SECRET);
OpenApplus.sync();
OpenApplus.setCallback(new OpenApplusCallback() {
@Override
public void invoke(OACallbackType type, JSONObject data, OpenApplusNotify notify) {
if (type == OACallbackType.OACallbackTypeAuthUser){
// 该接口仅供测试使用,请使用服务端发送给授权请求
OARequestWrapper requestWrapper = OpenApplus.makeRequestWrapper(SampleContants.SERVER_APPID, SampleContants.SERVER_APP_SECRET);
OAAuthDtoWrapper dto = new OAAuthDtoWrapper();
dto.setUid("1");
try {
dto.setCode(data.getString("code"));
} catch (JSONException e) {
e.printStackTrace();
}
String deviceID = Settings.Secure.getString(WXEnvironment.sApplication.getApplicationContext().getContentResolver(),
Settings.Secure.ANDROID_ID);
dto.setDeviceid(deviceID);
requestWrapper.sendObject(dto, notify);
}
}
});
注意:
参数1:上下文,必须的参数,不能为空
参数2:OpenApplus app key,必须参数。
参数3:OpenApplus app secret,必须参数。
添加相关权限
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.CAMERA"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="com.android.launcher.permission.INSTALL_SHORTCUT"/>
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW"/>
<uses-permission android:name="android.permission.SYSTEM_OVERLAY_WINDOW"/>
<uses-permission android:name="android.permission.VIBRATE"/>
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>
<uses-permission android:name="android.permission.READ_LOGS"/>
<!-- 这个权限用于进行网络定位 -->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
<!-- 这个权限用于访问GPS定位 -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE"/>
<uses-permission android:name="android.permission.ACCESS_GPS"/>
<uses-feature android:name="android.hardware.camera"/>
<uses-feature android:name="android.hardware.camera.autofocus"/>
<uses-permission android:name="getui.permission.GetuiService.com.bmdoctor.jyt"/>
<!--amap额外权限-->
<uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS"/>
代码混淆
如果您的应用使用了混淆,请添加
-keep class com.openapplus.** {*;}
添加Activty入口
在AndroidManifest.xml中添加
<activity android:name="com.openapplus.activity.OATinyProgramActivity">
<intent-filter>
<action android:name="android.intent.action.VIEW"/>
<category android:name="android.intent.category.DEFAULT"/>
<category android:name="com.benmu.weex.example.categoty.page"/>
<data android:scheme="http"/>
<data android:scheme="https"/>
</intent-filter>
</activity>
启动小程序容器
Intent intent = new Intent(SplashActivity.this, OATinyProgramActivity.class);
intent.putExtra("tiny","openapplus://jsApp/xxxxx");
startActivity(intent);
finish();
问题
1、运行lipo -info OpenApplus.framework/OpenApplus,如果发现缺少arm64支持,请下载压缩包内容并覆盖,可能是下载出现问题。