关键词:O2OA,安卓客户端编译,安卓APP,源码编译

O2OA是真正全代码开源的应用开发平台,开发者可以直接使用从github或者gitee上clone的源码编译成安卓客户端,代码可以修改,安全可靠,无限制。本文主要介绍如何从gitee上下载源码并且完成安卓客户端编译打包工作。


O2平台Android客户端,最低支持Android版本4.4 Android KitKat,编程语言主要使用kotlin


环境安装

请使用最新版本的Android Studio进行导入编译,编译的Android SDK版本是 28 Android Studio下载地址https://developer.android.google.cn/studio/



安装Android Studio完成后,打开设置里面的SDK Manager工具。

image


选择Android 9.0 (Pie) ,安装SDK。

image.png

然后选择SDK Tools 选项卡,勾选右下角的Show Package Details,然后选择Android SDK Build-Tools 下面的28.0.3版本进行安装。

image.png

导入项目

打开Android Studio 点击Open an existing Android Studio project

image

等它加载完成后可能会弹出这样一个窗口,让你更新gradle版本,这个不需要更新,点击 Donot remind me again for this project

image

项目基本信息修改

项目名称

项目名称就是Android手机桌面上显示的名称,这个名称修改是在strings资源文件中:

具体位置:./app/src/main/res/values/strings.xml

image

还有就是项目的LOGO,这个LOGO是在Android手机桌面上显示那个图标,这个需要替换图片: 图片位置: ./app/src/main/res 这个资源目录下有4个 mipmap 文件夹,把4个文件夹中的logo.pnglogo_round.png都替换了。

image

image

唯一应用ID

Android应用都有一个唯一的应用ID applicationId 。这个id代表这个Android App所以不能重复,一般都用公司域名组成的一串字符串,如: com.baidu.app.xxx 。 修改的文件是在./app/build.gradle 文件中,android -> defaultConfig -> applicationId 。

image

可配置的应用内图标

App内看到的一些O2OA相关的logo图标,可以不编译打包进App,我们服务端可以进行动态配置。用管理员进入我们O2OA的服务端,找到系统设置->移动办公配置->样式配置,就可以修改图标了:

image


第三方SDK注册配置

找到项目根目录下的 local.properties 文件,里面有一些第三方SDK的key需要配置。

# 下面是第三方SDK 需要的key

# 极光推送

JPUSH_APPKEY_DEBUG=极光推送AppKey

#百度语音

BAIDU_SPEECH_APPID=百度语音AppId

BAIDU_SPEECH_SECRET=百度语音Secret

BAIDU_SPEECH_APPKEY=百度语音Appkey

#百度地图

BAIDU_MAP_APPKEY=百度地图Appkey

#腾讯bugly

BUGLY_APPID=腾讯Bugly AppId

这些key具体的注册获取,下面有大致说明。

百度语音识别和语音合成

百度语音的官方地址:http://yuyin.baidu.com/ 。 点击右上角控制台登录后,创建应用

image

注册完成后,查看应用详情,就能看到百度语音相关的AppId、AppKey、SecretKey。把这3个字段内容拷贝到local.properties文件中对应的地方。

image

百度地图

百度地图官方地址:http://lbsyun.baidu.com/ 登录,进入控制台,创建应用。

image

如图这里有一个必填项SHA1,这个SHA1需要用到Android 打包的签名文件。所以先要有一个签名文件。

生成签名文件

签名文件可以用Android Studio 生成。先找到Android Studio菜单 Build -> Generate Signed Bundle or APK 。

image

然后勾选APK ,下一步。 image

然后点击新建按钮,创建一个新的签名文件。 image

下面就是签名文件生成的表单,填写完成后点击OK 就生成了。 image

获取百度地图需要的SHA1

使用keytool生成SHA1

  • 运行进入控制台(以Window开发环境为例)

image

and_key6.png

image

and_key7.png

  • 定位到.android文件夹下,输入cd .android

image

and_key8.png

  • 继续在控制台输入命令。 命令为:keytool -list -v -keystore 这里写上面生成的那个签名文件的全路径
  • 输入密码获取。 提示输入签名文件密码。输入密码后回车,此时可在控制台显示的信息中获取SHA1值,如下图所示:

image

and_key9.png

image

and_key10.png

把这里显示的SHA1的值拷贝到刚才百度地图应用创建页面表单中 ,创建地图应用成功后,到应用列表页面拷贝应用的AK就是AppKey的值。

image

然后把这个值填入local.properties文件中对应的百度地图Appkey的位置。

极光

极光官方网站:https://www.jiguang.cn 注册登录后,先创建应用。 image

应用创建后应用信息里面有一个AppKey,把值拷贝后粘贴到local.properties 文件中的极光推送AppKey对应的地方 JPUSH_APPKEY

还是在极光应用管理界面点击左边的 推送设置 菜单,把你的应用ID填写进Android那栏: image




直连版本配置

如果你不希望连接到我们O2云,通过修改配置编译打包,生成的Android应用,就会直接连接到你们自己的O2OA服务器。

直连版本的消息推送配置查看:https://www.yuque.com/docs/share/d9b8e231-bfcc-48cf-a671-141fd927f78f?# 《O2OA移动端APP直连版本如何开启消息推送》

修改方式如下: 在app目录下的build.gradle文件中,找到 android -> buildTypes ,把InnerServer 改成 true 。这里应用有两个 一个debug下的 一个是release下的

buildConfigField "Boolean", "InnerServer", "true"

image

然后找到app->assets 目录下找到server.json文件,把里面的centerHost 、 centerPort、httpProtocol改成你们自己的O2OA中心服务器地址信息。

image



不需要更新app

如果想要不自动更新app,不弹出更新提示,需要到LaunchActivity.kt 文件中找到下图位置,把 checkAppUpdate() 注释掉,然后写入 launch()

image.png




打包Android apk

打包还是通过Android Studio工具。上面提到的生成签名文件的时候一样,找到菜单 Build -> Generate Signed Bundle or APK 。

image

然后勾选APK ,下一步。 image

这次不用新建了因为刚才已经创建好签名文件了,选择你刚才生成的签名文件,输入密码,然后继续。 image

这里的签名版本V1和V2都勾选。点击 Finish 就开始打包了。 打包完成后,APK文件在 ./app/O2PLATFORM/release/O2PLATFORM-4.8.0.apk


app下载地址配置

我们O2OA平台登陆页扫码登录的二维码,有两个功能:

第一个是通过app扫码登录

第二个是如果手机还没有安装我们的app,通过其他app,如微信,扫码就会跳转到app的下载安装地址

image

登录页

image

登录页2

app的下载安装地址可以配置,打开o2server/config/collect.json ,如果没有这个文件就到o2server/configSample目录下复制一个过去。{

"appUrl": "https://sample.o2oa.net/app/download.html" ##app下载地址


}



官方网站:

官方网站 : http://www.o2oa.net

下载地址 : http://www.o2oa.net

oschina项目主页 : https://www.oschina.net/p/o2oa

推荐文章:

用车管理使用手册
2021-03-16
O2OA平台应用市场提供了用车管理模块,用户可以直接从应用市场下载并安装模块,满足企业用车管理相关关的业务需求。本文主要介绍用车管理的下载安装以及设计相关说明
源码调试-后端Java代码的远程调试
2021-04-26
O2OA是真正全代码开源的应用开发平台,开发者可以直接使用从github或者gitee上clone的源码编译成安卓客户端,代码可以修改,安全可靠,无限制。O2O
系统配置-配置服务器连接O2云
2022-01-25
O2OA拥有云端应用市场以及配套的移动办公APP,支持IOS和安卓端。用户可在连接O2云之后,使用APP使用移动办公。移动办公APP开放源代码,不会产生任何费用
快速入门-平台相关资料汇总
2021-02-07
一、官网http://www.o2oa.net/download.html二、前端框架https://mootools.net/三、jpahttps://www
服务集成-发送用户账号密码进行登录认证
2021-03-02
O2OA提供多种SSO单点认证方式,比如约定密钥,OAuth2,SMAP等等。本文主要演示如何发送用户账号密码进行登录认证。
云服务器-阿里云ECS服务器的端口启用
2021-02-07
O2OA成功启动后,有可能无法正常访问服务器,需要在ECS进行安全策略配置,开放端口:80、20020、20030在阿里云上完成O2OA平台部署,并且启动完成后
源码编译-Android客户端编译打包处理
2021-03-15
O2OA是真正全代码开源的应用开发平台,开发者可以直接使用从github或者gitee上clone的源码编译成安卓客户端,代码可以修改,安全可靠,无限制。本文主
考勤管理-新版
2021-09-06
@企业办公系统@考勤管理@开源办公系统@员工考勤@人事考勤O2OA考勤管理提供了一个通用的考勤管理,企业可以使用它实现手机打卡,数据导入,数据分析,数据统计。员
Office在线协作使用手册
2022-01-04
@在线Word编辑@在线协同@开源办公系统@在线Excel编辑@在线Office @文档管理@文档协同O2OAOffice在线协作模块,可以让使用者完全基于浏览
开发知识-中标麒麟安装达梦数据库(DM8)
2021-02-07
环境说明操作系统版本:NeoKylinLinuxAdvancedServerreleaseV7Update6(Chromium)1.前期准备工作1.1数据库下载

results matching ""

    No results matching ""