O2OA使用手册
第1章 功能简介及概述
第6章 平台部署与配置
  • 6.1 安装部署-在Windows系统中部署O2OA开发平台
  • 6.2 安装部署-在Linux系统中部署O2OA开发平台
  • 6.3 安装部署-在宝塔/PHPStudy中部署O2OA开发平台
  • 6.4 安装部署-O2OA开发平台之HTTP端口规划
  • 6.5 安装部署-平台服务器版本升级操作说明
  • 6.6 安装部署-私有化部署服务器架构推荐
  • 6.7 安装部署-O2OA开发平台集群部署配置及操作说明
  • 6.8 安装部署-在线部署自定义应用的WAR包和JAR包
  • 6.9 服务器配置与管理-​O2OA主要配置文件说明
  • 6.10 服务器配置与管理-服务器端口冲突和端口修改
  • 6.11 服务器配置与管理-如何修改服务器内存占用率?
  • 6.12 服务器配置与管理-如何访问和操作H2内置数据库
  • 6.13 服务器配置与管理-​如何在O2OA中使用MySQL数据库?
  • 6.14 服务器配置与管理-如何修改平台支持的数据库驱动包
  • 6.15 服务器配置与管理-O2OA使用openGauss(华为高斯数据库)配置
  • 6.16 服务器配置与管理-O2OA开发平台平台数据库配置信息样例
  • 6.17 服务器配置与管理-配置O2OA服务器连接O2云
  • 6.18 服务器配置与管理-O2OA实现服务器随操作系统自动启动
  • 6.19 服务器配置与管理-文件存储服务器配置
  • 6.20 服务器配置与管理-工作日节假日配置
  • 6.21 服务器配置与管理-为平台增加全文检索功能
  • 6.22 服务器配置与管理-消息提醒配置说明
  • 6.23 服务器配置与管理-自定义消息提醒
  • 6.24 服务器配置与管理-定制消息通知的内容
  • 6.25 服务器配置与管理-消息通知过滤
  • 6.26 服务器配置与管理-为待办创建配置邮件通知
  • 6.27 服务器配置与管理-待办待阅数据的查询操作和管理
  • 6.28 服务器配置与管理-​自动执行平台数据的备份与恢复
  • 6.29 服务器配置与管理-数据导出导入与系统数据备份
  • 6.30 ​服务器配置与管理-定期自动执行数据备份与恢复
  • 6.31 系统安全-O2OA作为认证中心实现基于OAUTH2单点认证
  • 6.32 系统安全-O2OA基于Nginx的SSL跳转、转发配置
  • 6.33 系统安全-访问日志相关配置
  • 6.34 系统安全-审计日志相关配置
  • 6.35 系统安全-平台日志文件说明
  • 6.36 系统安全-O2OA日志输出设置log4j2.xml
  • 6.37 系统安全-用户密码初始化规则的设定
  • 6.38 系统安全-启用HTTPS(百度云版)
  • 6.39 系统安全-启用HTTPS(腾讯云版)
  • 6.40 系统安全-自签名SSL证书验证HTTPS功能
  • 6.41 系统安全-登录密码RSA加密
  • 6.42 系统安全-用户登录IP限制
  • 6.43 系统安全-在用户登录过程中启用图形验证码
  • 6.44 系统安全-平台部署之使用非root用户运行服务
  • 6.45 系统安全-O2Server启用国密加密设置
  • 6.46 系统安全-日志应用使用说明
  • 6.47 系统安全-用户重置密码操作
  • 6.48 系统安全-超级管理员(xadmin)密码修改
  • 6.49 系统安全-使用Web端运行服务器管理命令
  • 6.50 系统安全-o2server无法正常显示验证码解决办法
  • 6.51 O2OA(翱途)开发平台前端安全配置建议(一)
  • 第16章 开发知识及常见问题
  • 16.1 如何替换登录页面二维码中默认的logo图标
  • 16.2 O2OA(翱途)流程引擎中如何修改,定制流程的流转记录
  • 16.3 mysql数据库备份
  • 16.4 domain不正确的时候如何强制设置成正确的
  • 16.5 配置文件中使用密文存储密码
  • 16.6 常见问题-连接MySQL出现 Public Key Retrieval is not allowed 的错误
  • 16.7 常见问题-查看表结构
  • 16.8 常见问题-7.2及以上版本开启web代理后请求中没有正确使用web端口问题解决方式
  • 16.9 linux环境libreoffice安装及使用
  • 16.10 在O2OA中使用网络会议(二):Openmeetings与O2OA认证配置
  • 16.11 在O2OA中使用网络会议(一):Openmeetings-5.1.0亲手安装整理 Step-By-Step
  • 16.12 藕粉社区问答系列1
  • 16.13 藕粉社区问答系列2
  • 16.14 藕粉社区问答系列3
  • 16.15 快速入门-平台相关资料汇总
  • 16.16 快速入门-服务器总体介绍汇总
  • 16.17 快速入门-流程表单载入基础数据
  • 16.18 快速入门-常用表单脚本样例汇总
  • 16.19 快速入门-自定义表数据分页样例
  • 16.20 OEM白标-如何修改平台中的Logo图标和文字
  • 16.21 云服务器-阿里云ECS服务器的端口启用
  • 16.22 开发知识-React篇:在O2OA平台框架中使用React
  • 16.23 开发知识-React篇:在O2OA门户页面中使用React
  • 16.24 开发知识-Vue篇:在Vue应用中集成O2OA
  • 16.25 开发知识-Vue篇:使用Vue-CLI开发O2应用
  • 16.26 开发知识-Vue篇:在O2门户页面中使用Vue
  • 16.27 平台中使用Druid数据库连接及监控
  • 16.28 开发知识-在PAAS平台上部署O2OA开发平台
  • 16.29 开发知识-如何使用Tomcat架设webdav服务器
  • 16.30 开发知识-单个端口模式的Nginx和系统配置
  • 16.31 开发知识-Linux非root用户如何使用80端口启动O2OA
  • 16.32 开发知识-O2OA平台启用Eruda进行移动端调试
  • 16.33 开发知识-神通数据库安装
  • 16.34 开发知识-人大金仓数据安装
  • 16.35 开发知识-中标麒麟安装达梦数据库(DM8)
  • 16.36 开发知识-中标麒麟安装人大金仓详细步骤
  • 16.37 开发知识-使用VNC连接中标麒麟V7操作系统
  • 16.38 开发知识-鲲鹏(ARM)麒麟操作系统如何替换yum源?
  • 16.39 开发知识-数据优化知识点
  • 16.40 水印安全-附件水印|加密|文档格式转换图片|PDF
  • 16.41 消息队列-配置activeMQ、kafka消息队列
  • 16.42 常见问题-数据导出或者导入时发生OOM异常
  • 16.43 常见问题-如何让用户在首次登录时,必须对初始密码进行修改
  • 16.44 常见问题-如何在模块部署中控制模块的访问权限
  • 16.45 常见问题-如何在平台中开发Ftp文件上传文件的服务?
  • 16.46 常见问题-如何使用服务管理调用WebService
  • 16.47 常见问题-如何使用脚本调用外部服务
  • 16.48 常见问题-如何使用脚本控制流程自动流转
  • 16.49 常见问题-如何通过脚本调用系统内服务
  • 16.50 常见问题-接口代码疑惑解答汇总
  • 16.51 常见问题:Maven编译o2server错误: Java Heap Space
  • 16.52 常见问题-集群配置后启动报错:NullPointerException
  • 16.53 常见问题-服务器错误:can not decrypt token
  • 16.54 常见问题-IOS移动办公无法收到验证码
  • 16.55 常见问题-服务器和日志时间相差12小时的问题
  • 16.56 常见问题-为什么127.0.0.1可以访问但其他IP无法访问
  • 16.57 藕粉社区问答系列4
  • 16.58 开发知识-React篇:在React应用中集成O2OA

  • 源码编译-Android客户端编译打包处理

    时间:2022-08-03   

    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工具。

    1577344557429-5f5242d4-89b0-426e-bf59-057a2e52686f (1).png

    选择Android 12.0 (S) ,安装SDK。

    image.png

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

    image-2.png

    导入项目

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

    1577344557509-a21b55b1-4241-4b5a-b642-aa6c74c8e549.png

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

    1577344558957-4a1ed875-17de-4d35-9a53-1fc14de8caff.png

    项目基本信息修改

    项目名称

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

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

    1577344557451-0d30193a-801c-43bd-94a5-b60ac07773a5.png

    项目桌面LOGO

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

    1577344557413-0780e7c6-8597-4239-a47a-b2aef0b879dc.png1577344557674-0bc05c23-9c26-409c-b2e4-5f16f92e7f8b.png

    唯一应用ID

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

    1577344557438-dee08395-93fd-427a-86be-871cc8701316.png

    可配置的应用内图标

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

    1577344557801-ec2b4bcd-cc97-44d0-a684-4694cbe8f8c7.png


    第三方SDK注册配置

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

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

    # 极光推送

    JPUSH_APPKEY_DEBUG=极光推送AppKey


    #百度地图

    BAIDU_MAP_APPKEY=百度地图Appkey


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


    百度地图

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

    1577344558217-293efb80-f026-4156-ad3c-d3dfe9748ce6.png


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

    生成签名文件

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

    1577344557830-5455350d-0083-4ab0-b9e3-67b5567d9c99.png


    然后勾选APK ,下一步。 

    1577344559047-295ae5ec-5cf1-435b-9c88-5fbcdd00d782.png

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

    1577344557981-c8c5b534-4135-47ca-a440-532b50494b2f.png

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

    1577344557421-c3dd988c-d22b-4a20-a89c-76adc3056ceb.png

    获取百度地图需要的SHA1

    使用keytool生成SHA1

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

    1577344557230-7ac13e97-108b-4a9d-9388-b3ac3b6bfad8.png

    and_key6.png

    1577344557047-b5e2cd20-1f6a-4f36-84c9-735a5d32b6bf.png


    and_key7.png

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

    1577344557060-b20789dc-900b-4c74-bc31-6e3fec1975b9.png


    and_key8.png

    • 继续在控制台输入命令。 命令为:keytool -list -v -keystore 这里写上面生成的那个签名文件的全路径

    • 输入密码获取。 提示输入签名文件密码。输入密码后回车,此时可在控制台显示的信息中获取SHA1值,如下图所示:


    1577344557262-81b2ecb1-6506-4d41-b4cd-88cc3e1e14ee.png


    and_key9.png

    1577344557047-164dd22c-1052-480c-bc79-7596fccd9b92.png

    and_key10.png

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

    1577344559091-ff11db3d-cdc2-4ceb-ade7-ed8242251134.png


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

    极光

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

    1577344557817-35371d38-f7de-4d8b-8044-840017594a97.png


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

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

    1577344559098-98b80796-7b36-4776-95a2-22cc7ce6d9f4.png

    直连版本配置

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

    直连版本的消息推送配置查看:《O2OA移动端APP直连版本如何开启消息推送》

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

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

    1577344559312-11600328-394a-4b1a-8798-b85c1af59219.png

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

    1577344559030-1735ff15-8980-42cf-a8c8-220d9d8ff200.png

    不需要更新app

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

    image - 2022-04-27T154142.625.png

    打包Android apk

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

    1577344557829-5b7d13c2-9b8c-4743-abb6-b7df21af84f9.png

    然后勾选APK ,下一步。 

    1577344558176-f5c3d53c-4483-4070-9164-49de977ef72e.png

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

    1577344558020-ea1b6356-e766-4b1f-a7f6-eff15dae770f.png

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

    app下载地址配置

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

    第一个是通过app扫码登录

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

    1577344559218-4b4cbf11-097c-4edd-bf55-8711b2155ab3.png

    登录页

    1577344559310-93fc0341-eda9-4102-9326-64fdb5842064.png



    登录页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