From 5693dfb4773a53ef8453ec9a784d7871b83e6582 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=BA=B7=E6=97=AD=E8=80=80?= Date: Fri, 5 Feb 2021 15:19:45 +0800 Subject: [PATCH] Update README.md --- README.md | 118 ++++++++++++++++++++++++++++++++++++++---------------- 1 file changed, 84 insertions(+), 34 deletions(-) diff --git a/README.md b/README.md index 7aada5d..5c4a818 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,25 @@ -# 五行代码让APP运行小程序 +# 安卓工程 readme -## 1、在工程的build.gradle中需要配置的内容 + +## 🤩 FinClip是什么? +有没有想过，能把一个已经开发好的微信小程序，放到你自己的APP里面运行？
想象一下，你只需要开发一次，就能把这个业务模块同时放到微信、自有App
甚至！你都不用开发业务，直接拖下来一个做好的业务模块，放到自己App里面，嘿！跑起来了！
听起来是不是有点不可思议？
没关系，这就是FinClip，帮助你实现这个不可思议！
+ +## 🤔 你要怎么做？
+只需要三个步骤： + +1. get一个小程序！你可以：
自己开发一个微信小程序
or 在我们的 [小程序生态圈](https://mp.finogeeks.com/#/ecosystem) 中挑一个小程序（支持直接下载代码包）
or 直接使用我们提供的项目：[https://github.com/finogeeks/miniprogram-demo](https://github.com/finogeeks/miniprogram-demo)） +1. 把finclip SDK集成到你的APP里面 +1. 登录[FinClip小程序开放平台](https://finclip.com/#/home)，完成关联 + +然后，见证奇迹，看看这个微信小程序直接在你的App里面运行起来的效果吧！
+ + +## 🔜 五行代码让你的App运行小程序 + +### 1、配置 build.gradle 在工程的`build.gradle`中添加maven仓库的地址： - -```groovy +``` buildscript { repositories { google() @@ -19,6 +34,7 @@ allprojects { repositories { google() jcenter() + maven { url "https://jitpack.io" } maven { url "https://gradle.finogeeks.club/repository/applet/" credentials { @@ -29,62 +45,96 @@ allprojects { } } ``` -## 2、在gradle中依赖SDK - -```groovy -implementation 'com.finogeeks.lib:finapplet:2.12.39' + +### 2、在gradle中依赖SDK ``` - -## 3、 配置混淆规则 - +implementation 'com.finogeeks.lib:finapplet:+' +``` + +### 3、 配置混淆规则 集成SDK之后，为了避免SDK中部分不能被混淆的代码被混淆，需要在工程的混淆规则配置文件中增加以下配置： - -```properties +``` -keep class com.finogeeks.** {*;} ``` -## 4、SDK初始化 - -我们强烈建议在`Application`中对SDK进行初始化，初始化SDK需要传入的各项参数如下： -```java + +### 4、SDK初始化 +我们强烈建议在`Application`中对SDK进行初始化，初始化SDK需要传入的各项参数如下：
❌ 不在application中初始化SDK也可以，但是一定要保证不在小程序进程中初始化小程序运行时SDK ❌ +``` FinAppConfig config = new FinAppConfig.Builder() - .setSdkKey("22LyZEib0gLTQdU3MUauATBwgfnTCJjdr7FCnywmAEM=") // 需替换为自己的SDK Key - .setSdkSecret("bdfd76cae24d4313") // 需替换为自己的SDK Secret - .setApiUrl("https://mp.finogeeks.com") // 需替换为对应后端服务的地址 - .setApiPrefix("/api/v1/mop/") // 需替换为对应后端服务的接口请求路由前缀 + .setAppKey("SDKKEY") + .setAppSecret("SECRET") + .setApiUrl("https://api.finclip.com") + .setApiPrefix("/api/v1/mop/") + .setGlideWithJWT(false) .build(); FinCallback callback = new FinCallback() { @Override public void onSuccess(Object result) { // SDK初始化成功 } - @Override public void onError(int code, String error) { // SDK初始化失败 Toast.makeText(AppletApplication.this, "SDK初始化失败", Toast.LENGTH_SHORT).show(); } - @Override public void onProgress(int status, String error) { - } }; FinAppClient.INSTANCE.init(this, config, callback); ``` +SDK采用多进程机制实现，每个小程序运行在独立的进程中，即一个小程序对应一个进程，在初始化SDK时，要特别注意的一点是： -SDK采用多进程机制实现，每个小程序运行在独立的进程中，即一个小程序对应一个进程，在初始化SDK时，要特别注意的一点是：小程序进程在创建的时候不需要执行任何初始化操作，即使是小程序SDK的初始化，也不需要在小程序进程中执行。例如：应用使用了一些第三方库，这些库需要在应用启动时先初始化，那么在`Application`中执行初始化时，只有当前进程为宿主进程时才需要初始化这些第三方库，小程序进程是不需要初始化这些库的。 +- 小程序进程在创建的时候不需要执行任何初始化操作，即使是小程序SDK的初始化，也不需要在小程序进程中执行 -因此，在初始化SDK之前，一定要判断当前进程是哪一个进程，如果是小程序进程，就不进行任何操作了： - -```java +**例如：**
应用使用了一些第三方库，这些库需要在应用启动时先初始化，那么在`Application`中执行初始化时，只有当前进程为宿主进程时才需要初始化这些第三方库，小程序进程是不需要初始化这些库的。
**因此**：在初始化SDK之前，一定要判断当前进程是哪一个进程，如果是小程序进程，就不进行任何操作了： +``` if (FinAppClient.INSTANCE.isFinAppProcess(this)) { return; } ``` + +### 5、打开小程序 +``` +FinAppClient.INSTANCE.getAppletApiManager().startApplet(this, "appid"); +``` +❌ 不要修改包名、key、secret、AppID ❌
+
但如果你需要把这些内容更改为自己的信息，你可以： -* **SDK Key** 和 **SDK Secret** 可以从免费一键部署的社区版的管理后台获取。 -* **apiUrl** 为小程平台后端服务的地址。 -* **apiPrefix** 为小程平台后端服务的接口请求路由前缀。 -* **小程序id** 为在管理后台上架的小程序appid。 -* 上述的参数可以在前文服务器部署的后台界面上获取，亦可以在没有部署服务端的情况下在[https://mp.finogeeks.com](https://mp.finogeeks.com)快速注册，免费获取。 -* 具体的操作方法请参考 [Android集成](https://mp.finogeeks.com/mop/document/runtime-sdk/sdk-integrate/android.html) +- **SDKKEY** 和 **Secret** 可以从[ FinClip开放平台](https://finclip.com/#/home) 获取，你也可以直接点击进入[注册页面](https://finclip.com/#/register) +- 进入平台后，在【应用管理】页面添加你自己的包名后，点击【复制】即可获得key\secret\apisever字段
+- **ApiUrl** 和 **apiPrefix **是固定字段，请直接参考本demo +- **小程序id** 为在管理后台上架的小程序AppID，需要在【小程序管理】中创建并在【应用管理】中关联
（与微信小程序ID不一样哦！这里是特指finclip平台的ID） + + + + +## 📚 想要通关全程？这里是全程攻略 +直接跑demo虽然快，不过快速通关总会留下各种遗憾。
来吧，跟随全程攻略，了解一下“让App运行小程序”的全貌吧： + +### 1、FinClip 平台是什么？ + +- Finclip平台是凡泰极客旗下的一款可私有化的小程序开放平台
+- 凡泰极客借鉴微信、支付宝等主流小程序平台技术，进一步打造出可私有化的小程序开放平台产品 —— FinClip，该平台主要由两个客户端组成，一个是运营端，负责审核小程序内容，确保小程序的内容符合合规要求；另一个是企业端，负责开发小程序及小程序上下架管理。 +- FinClip 面向全行业发布，尤其适合金融业及其他需要自建数字化生态以及实现业务场景敏捷迭代的行业，帮助合作伙伴构建一个安全、合规、可控的小程序生态。 + +### 2、FinClip 平台的特色？ + +- 多端上线：同一小程序可以同步上线多个宿主端（即小程序可上线的 APP），为开发者节省大量的人力和时间。 +- 合规引流：解决“行业应用嵌入第三方网络空间”的安全合规问题，合规引流，连接金融服务场景。 +- 方便快捷：相较于 APP，小程序开发周期短，开发成本低等特性让更多的开发者能够轻松、快速的参与到开发过程中，实现快速上线，快速起量。 +- 优质体验：小程序拥有优于现有 H5 页面的用户体验，帮助企业/机构获取更多渠道用户，同时节省获客成本。 +- 部署方式：满足合规监管多种部署方式，支持私有化部署、混合部署、行业云部署。 + +### 3、FinClip 有哪些典型案例？ +（如需了解更多案例，可以与小助手联系呀） + +![图片.png](https://www-cdn.finclip.com/images/yippi.jpeg) + + +## ⛳️ 获得更多指引 +✅ 部署一套私有化社区版：[https://www.finclip.com/mop/document/quickstart/Community-Edition.html](https://www.finclip.com/mop/document/quickstart/Community-Edition.html)
✅ 了解安卓相关API：[https://www.finclip.com/mop/document/runtime-sdk/sdk-api/android.html](https://www.finclip.com/mop/document/runtime-sdk/sdk-api/android.html)
✅ 了解更多安卓常见问题：[https://www.finclip.com/mop/document/faq/SDK/Android-SDK.html](https://www.finclip.com/mop/document/faq/SDK/Android-SDK.html)
+ + +## ☎️ 与我们联系 +如想进入FinClip小程序技术群交流探讨，或了解更多使用场景，请添加小助手微信。
![](https://cdn.nlark.com/yuque/0/2021/png/679837/1612498062501-9cb75ea0-7567-46ac-a62c-1ad3397246fb.png#align=left&display=inline&height=213&margin=%5Bobject%20Object%5D&originHeight=611&originWidth=573&size=0&status=done&style=none&width=200)