家喻户晓,不论是Flutter还是uni-app,其实都是一个UI框架,他们都是运行在原生零碎之上的。天然,咱们能够在Flutter工程中集成uni-app。

Android 集成uni-app

一、下载离线SDK

首先,咱们创立一个Flutter一般利用,并应用Android Studio关上Android工程。接下来,关上uni-app官网,下载最新Android离线SDK,如下图所示。

解压后,能够应用Android Studio关上外面的我的项目HBuilder-Integrate-AS查看运行成果。关上下载的uni-app SDK目录,如下图所示。

SDK目录阐明如下:

    |-- HBuilder-Hello                App离线打包演示利用    |-- HBuilder-Integrate-AS        集成uni-app的最简示例    |-- SDK                            SDK库文件目录    |-- Feature-Android.xls            Android平台各扩大Feature API对应的具体配置    |-- Readme.txt                    版本阐明文件及注意事项    |-- UniPlugin-Hello-AS            uni原生插件开发示例

二、 配置工程

2.1 根底库配置

而后,咱们看一下如何在原生Android工程中集成uni-app SDK。如果还没有原生Android工程,能够新建一个。而后,将将lib.5plus.base-release.aar、android-gif-drawable-release@1.2.17.aar、uniapp-v8-release.aar和oaid_sdk_1.0.25.aar拷贝到libs目录下。

在build.gradle中增加资源援用,因为下面都是aar形式,那么只须要增加include: ['*.aar', '*.jar']即可引入进来。

 implementation fileTree(dir: 'libs', include: ['*.aar', '*.jar'], exclude: []) implementation "com.android.support:support-v4:28.0.0" implementation "com.android.support:appcompat-v7:28.0.0" implementation 'com.android.support:recyclerview-v7:28.0.0' implementation 'com.facebook.fresco:fresco:1.13.0' implementation "com.facebook.fresco:animated-gif:1.13.0" implementation 'com.github.bumptech.glide:glide:4.9.0' implementation 'com.alibaba:fastjson:1.1.46.android'

uni-app配置时还须要在build.gradle的android节点中增加aaptOptions配置,如下所示。

 aaptOptions {       additionalParameters '--auto-add-overlay'       ignoreAssetsPattern "!.svn:!.git:.*:!CVS:!thumbs.db:!picasa.ini:!*.scc:*~"   }

2.2 利用配置

配置Appkey

从3.1.10版本起,集成uni-app须要申请 Appkey,申请Appkey请参考。

而后,关上Androidmanifest.xml, 导航到Application节点,创立meta-data节点,name为dcloud_appkey,value为申请的AppKey。

<application  ...>  <meta-data      android:name="dcloud_appkey"      android:value="替换为本人申请的Appkey" />

配置利用版本号


如果须要更改版本等信息,能够批改defaultConfig节点上面的配置。

  • versionCode:为利用的版本号(整数值),用于各利用市场的降级判断,倡议与manifest.json中version -> code值统一
  • versionName:为利用的版本名称(字符串),在零碎利用管理程序中显示的版本号,倡议与manifest.json中version -> name值统一。
  • applicationId:为利用的包名,个别设置为反向域名,不倡议批改。

同时,倡议将targetSdkVersion设置为25或以上。App离线SDK minSdkVersion最低反对21,小于21在局部5.0以下机型上将无奈失常应用。

apply plugin: 'com.android.application'android {    compileSdkVersion 29    defaultConfig {        applicationId "com.example.myapplication"        minSdkVersion 21        targetSdkVersion 28        versionCode 1        versionName "1.0"        multiDexEnabled true    }    buildTypes {        release {            minifyEnabled false            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'        }    }}dependencies {    implementation fileTree(dir: 'libs', include: ['*.aar', '*.jar'], exclude: [])    implementation 'com.github.bumptech.glide:glide:4.9.0' // 基座依赖    implementation 'com.android.support:support-v4:28.0.0'    implementation 'com.alibaba:fastjson:1.1.46.android'}

配置利用启动页及provider节点

关上Androidmanifest.xml文件,并且新建的我的项目默认会有一个MainActivity的节点,必须要删除,其余参考上面的代码增加。

 <activity        android:name="io.dcloud.PandoraEntry"        android:configChanges="orientation|keyboardHidden|keyboard|navigation"        android:label="@string/app_name"        android:launchMode="singleTask"        android:hardwareAccelerated="true"        android:theme="@style/TranslucentTheme"        android:screenOrientation="user"        android:windowSoftInputMode="adjustResize" >        <intent-filter>            <action android:name="android.intent.action.MAIN" />            <category android:name="android.intent.category.LAUNCHER" />        </intent-filter>    </activity>    <activity        android:name="io.dcloud.PandoraEntryActivity"        android:launchMode="singleTask"        android:configChanges="orientation|keyboardHidden|screenSize|mcc|mnc|fontScale|keyboard"        android:hardwareAccelerated="true"        android:permission="com.miui.securitycenter.permission.AppPermissionsEditor"        android:screenOrientation="user"        android:theme="@style/DCloudTheme"        android:windowSoftInputMode="adjustResize">        <intent-filter>            <category android:name="android.intent.category.DEFAULT" />            <category android:name="android.intent.category.BROWSABLE" />            <action android:name="android.intent.action.VIEW" />            <data android:scheme="h56131bcf" />        </intent-filter>    </activity>    <!--provider节点必须增加-->    <provider        android:name="io.dcloud.common.util.DCloud_FileProvider"        android:authorities="${apk.applicationId}.dc.fileprovider"        android:exported="false"        android:grantUriPermissions="true">        <meta-data            android:name="android.support.FILE_PROVIDER_PATHS"            android:resource="@xml/dcloud_file_provider" />    </provider>

其余配置

正式打包之前,还须要配置利用图标和启动界面。

  • icon.png为利用的图标。
  • push.png为推送音讯的图标。
  • splash.png为利用启动页的图标。



留神:splash.png在不同设施上显示成果不一样,为防止出现拉伸的情况,倡议应用Android studio生成.9.png类型图片。

资源配置

手动新建一个assets文件夹,地位与java目录同级。而后,将SDK->assets->data文件夹拷贝到assets文件夹下,如下图所示。

而后,在assets文件夹下创立apps文件夹,并将HBuilderX我的项目导出的资源复制到assets->apps文件中,如下图所示。

生成HBuilderX我的项目资源能够参考:生成本地打包 APP 资源。抉择我的项目 -> 发行 -> 原生App-本地打包 -> 生成本地打包App资源.

实现上述操作后,须要批改dcloud_control.xml文件,确保dcloud_control.xml中的appid与manifest.json中的id与文件夹名统一,如下图所示。

生成自定义基座,须要在根节点下增加debug="true"syncDebug="true",如下图。

这个自定义基座反对热更新须要将debug-server-release.aar打入apk中,生成正式包时能够删除,能够参考:具体步骤可参考链接。

最初,依照Android代码的运行形式一样运行即可,成果如下图。

iOS集成uni-app

一、下载离线SDK

和原生iOS工程集成其余的SDK一样,在Flutter工程中集成uni-app须要先下载离线的SDK。关上uni-app官网,而后下载iOS的最新离线SDK。

解压后,文件的目录构造如下图。

    |-- HBuilder-Hello       给用户打uni-app我的项目的离线打包工程    |-- Feature-iOS.xls      配置表(依赖的库、资源文件、参数配置等)    |-- SDK                 工程须要的库文件,.h头文件,配置文件,资源文件

咱们能够间接运行HBuilder-Hello 工程来查看运行成果。

二、 增加根底依赖库及资源文件

根底依赖库及资源是必须要引入到工程中的,根底依赖库及资源寄存在 UniMPSDK/Core 目录,目录构造如下所示。

|-- UniMPSDK/Core    |-- Headers          // .h 头文件    |-- Libs             // 根底依赖库    |-- Resources        // 资源文件

2.1 增加根底库

应用Xcode关上iOS工程,而后在 Xcode 我的项目左侧目录选中工程名,在 【TARGETS】->【Build Phases】->【 Link Binary With Libaries】 中点击【+】按钮,在弹出的窗口中点击 【Add Other】 ->【 Add Files...】,而后关上 UniMPSDK/Core/Libs 根底依赖库目录,选中目录中的 .a 库以及 .framework 库单击 open 按钮将依赖库增加到工程中。


2.2 增加零碎依赖库

在 Xcode 我的项目左侧目录选中工程名,在 TARGETS->Build Phases-> Link Binary With Libaries 中点击“+”按钮,在弹出的窗口中查找并抉择所需的库(见下表),单击 “Add” 按钮,将库文件增加到工程中。

须要依赖的库有如下一些:

  • JavaScriptCore.framework
  • CoreMedia.framework
  • MediaPlayer.framework
  • AVFoundation.framework
  • AVKit.framework
  • GLKit.framework
  • OpenGLES.framework
  • CoreText.framework
  • QuartzCore.framework
  • CoreGraphics.framework
  • libc++.tbd
  • QuickLook.framework
  • CoreTelephony.framework
  • AssetsLibrary.framework
  • CoreLocation.framework
  • AddressBook.framework
  • libiconv.tbd

2.3 增加依赖资源文件

接下来,还须要增加依赖资源文件,倡议在我的项目中新建一个 Group来治理资源文件。如示例在工程目录中创立的 UniMP 文件夹,而后按功能模块创立不同的目录寄存资源文件; 增加资源文件办法:在左侧目录中选中导入资源文件的地位(示例中是 UniMP/Core),在右键菜单中选择Add Files to “工程名...”,而后关上 UniMPSDK/Core 目录,抉择 Resources 文件夹,而后点击“Add”,将资源文件增加到工程中。

2.4 增加 .h 头文件

在Xcode左侧目录中选中导入头文件的地位(示例中是 UniMP/Core),在右键菜单中选择Add Files to “工程名...”,而后关上 UniMPSDK/Core 目录,抉择 Headers 文件夹,而后点击“Add”,将头文件资源增加到工程中。

生成小程序利用资源

首先在 HBuilderX 中抉择您的 uni-app 我的项目,如果没有请新建一个 uni-app 我的项目,如下图。

而后,选中您的我的项目,右键->发行->原生App-制作利用wgt包。

点击“浏览” 抉择wgt包导出门路,点击 “生成wgt”,如下图。

我的项目编译实现后会在控制台输入wgt包的门路,点击门路关上 wgt 资源包所在目录。

四、导入小程序资源

关上原生工程目录在 UniMP 门路中创立名称为Apps的文件夹,将之前导出的wgt包拷贝到Apps文件夹中,如下图。

而后,在原生工程中左侧目录中选中导资源文件的地位(示例中是 UniMP/),在右键菜单中选择Add Files to “工程名...”,而后关上工程目录,抉择 Apps 文件夹,而后点击“Add”,将利用资源包增加到工程中,如下图所示。

五、批改代码

首先,须要初始化SDK引擎,并设置启动参数,倡议在application:didFinishLaunchingWithOptions 办法中增加,在 AppDelegate.m 中援用头文件 #import "DCUniMP.h"#import "WeexSDK.h",如下所示。

#import "DCUniMP.h"#import "WeexSDK.h"- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {    // Override point for customization after application launch.        // 配置参数    NSMutableDictionary *options = [NSMutableDictionary dictionaryWithDictionary:launchOptions];    // 设置 debug YES 会在控制台输入 js log,默认不输入 log,注:须要引入 liblibLog.a 库    [options setObject:[NSNumber numberWithBool:YES] forKey:@"debug"];    // 初始化引擎    [DCUniMPSDKEngine initSDKEnvironmentWithLaunchOptions:options];        // 注册 module 注:module的 Name 须要保障惟一, class:为 module 的类名    [WXSDKEngine registerModule:@"TestModule" withClass:NSClassFromString(@"TestModule")];    // 注册 component 注:component 的 Name 须要保障惟一, class:为 component 的类名    [WXSDKEngine registerComponent:@"testmap" withClass:NSClassFromString(@"TestMapComponent")];        return YES;}

而后,在 AppDelegate.m App 的生命周期办法中调用 SDK 相干办法,如下所示。

#pragma mark - App 生命周期办法- (void)applicationDidBecomeActive:(UIApplication *)application {    [DCUniMPSDKEngine applicationDidBecomeActive:application];}- (void)applicationWillResignActive:(UIApplication *)application {    [DCUniMPSDKEngine applicationWillResignActive:application];}- (void)applicationDidEnterBackground:(UIApplication *)application {    [DCUniMPSDKEngine applicationDidEnterBackground:application];}- (void)applicationWillEnterForeground:(UIApplication *)application {    [DCUniMPSDKEngine applicationWillEnterForeground:application];}- (void)applicationWillTerminate:(UIApplication *)application {    [DCUniMPSDKEngine destory];}

并且,还能够依据我的项目需要实现以下办法。

#pragma mark - 如果须要应用 URL Scheme 或 通用链接相干性能,请实现以下办法- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options {    // 通过 url scheme 唤起 App    [DCUniMPSDKEngine application:app openURL:url options:options];    return YES;}- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray<id<UIUserActivityRestoring>> * _Nullable))restorationHandler {    // 通过通用链接唤起 App    [DCUniMPSDKEngine application:application continueUserActivity:userActivity];    return YES;}

接下来,须要关上小程序的文件中增加以下逻辑,参考示例工程 ViewController.m 。首先,须要援用头文件。

#import "DCUniMP.h"

增加代理协定, DCUniMPEngineDelegate类,如下。

@interface ViewController () <DCUniMPSDKEngineDelegate>@end

小程序利用资源必须部署到指定的沙盒门路中才能够失常运行,如下。

/// 查看运行目录是否存在利用资源,不存在将利用资源部署到运行目录- (void)checkUniMPResource {    // 留神:isExistsApp: 办法仅是判断运行目录中是否存在利用资源,正式环境应该增加版本控制,内置新的wgt资源后须要判断版本,决定是否须要开释利用资源     if (![DCUniMPSDKEngine isExistsApp:k_AppId]) {        // 读取导入到工程中的wgt利用资源        NSString *appResourcePath = [[NSBundle mainBundle] pathForResource:k_AppId ofType:@"wgt"];        // 将利用资源部署到运行门路中        if ([DCUniMPSDKEngine releaseAppResourceToRunPathWithAppid:k_AppId resourceFilePath:appResourcePath]) {            NSLog(@"利用资源文件部署胜利");        }    }}

最初是在原生代码中关上小程序的代码,如下。

/// 关上 uni 小程序- (IBAction)openUniMP:(id)sender {    // 初始化小程序的配置信息对象    DCUniMPConfiguration *configuration = [[DCUniMPConfiguration alloc] init];    [DCUniMPSDKEngine openUniMP:k_AppId configuration:configuration completed:^(DCUniMPInstance * _Nullable uniMPInstance, NSError * _Nullable error) {        if (uniMPInstance) {            // success        } else {            // error        }    }];}

能够通过示例代码运行查看成果。