O2OA使用手册
第一章 服务器部署及管理
  • 1.1 平台服务器主机架构配置推荐
  • 1.2 平台服务器版本升级操作说明
  • 1.3 o2server无法正常显示验证码解决办法
  • 1.4 在宝塔面板中安装O2OA(For Linux)
  • 1.5 系统安全-启用HTTPS(腾讯云版)
  • 1.6 系统安全-自签名SSL证书验证HTTPS功能
  • 1.7 系统安全-加密登录-登录密码RSA加密
  • 1.8 功能部署-为平台增加全文检索功能
  • 1.9 平台维护-流转中工作数据的查询、操作和管理
  • 1.10 平台维护-待办待阅数据的查询操作和管理
  • 1.11 平台维护-自动执行平台数据的备份与恢复
  • 1.12 平台维护-备份和恢复平台数据操作
  • 1.13 平台维护-在线部署自定义应用的WAR包和JAR包
  • 1.14 平台服务器下载及安装部署-Windows系统
  • 1.15 开源平台O2OA服务器下载及安装部署(Linux环境)
  • 1.16 华为云服务器部署O2OA-麒麟操作系统
  • 1.17 平台维护-使用Web端运行服务器管理命令
  • 1.18 密码管理-超级管理员密码修改
  • 1.19 密码管理-普通用户初始化密码设置
  • 1.20 密码管理-用户重置密码操作
  • 1.21 系统配置-如何访问和操作内置数据库-H2
  • 1.22 系统配置-第三方数据库配置-MySQL
  • 1.23 日志管理-访问日志相关配置
  • 1.24 日志管理-审计日志相关配置@日志管理
  • 1.25 日志管理-平台日志文件说明
  • 1.26 系统架构-集群部署配置及操作说明
  • 1.27 系统架构-基于nginx快速集群部署-端口分发
  • 1.28 系统配置-主要配置文件说明
  • 1.29 系统配置-配置服务器连接O2云
  • 1.30 系统配置-流程催办提醒配置
  • 1.31 系统配置-自定义消息提醒
  • 1.32 系统配置-消息提醒配置说明
  • 1.33 系统配置-文件存储服务器配置
  • 1.34 系统配置-工作日节假日配置
  • 1.35 系统配置-开机自动启动O2Server
  • 1.36 系统安全-启用HTTPS(百度云版)
  • 1.37 系统架构-基于nginx快速集群部署-上下文分发
  • 第十五章 开发知识及常见问题
  • 15.1 藕粉社区问答系列1
  • 15.2 藕粉社区问答系列2
  • 15.3 藕粉社区问答系列3
  • 15.4 快速入门-平台相关资料汇总
  • 15.5 快速入门-服务器总体介绍汇总
  • 15.6 快速入门-流程表单载入基础数据
  • 15.7 快速入门-常用表单脚本样例汇总
  • 15.8 快速入门-自定义表数据分页样例
  • 15.9 OEM白标-如何修改平台中的Logo图标和文字
  • 15.10 云服务器-阿里云ECS服务器的端口启用
  • 15.11 开发知识-React篇:在O2OA平台框架中使用React
  • 15.12 开发知识-React篇:在O2OA门户页面中使用React
  • 15.13 开发知识-Vue篇:在Vue应用中集成O2OA
  • 15.14 开发知识-Vue篇:使用Vue-CLI开发O2应用
  • 15.15 开发知识-Vue篇:在O2门户页面中使用Vue
  • 15.16 平台中使用Druid数据库连接及监控
  • 15.17 开发知识-在PAAS平台上部署O2OA开发平台
  • 15.18 开发知识-如何使用Tomcat架设webdav服务器
  • 15.19 开发知识-单个端口模式的Nginx和系统配置
  • 15.20 开发知识-Linux非root用户如何使用80端口启动O2OA
  • 15.21 开发知识-O2OA平台启用Eruda进行移动端调试
  • 15.22 开发知识-神通数据库安装
  • 15.23 开发知识-人大金仓数据安装
  • 15.24 开发知识-中标麒麟安装达梦数据库(DM8)
  • 15.25 开发知识-中标麒麟安装人大金仓详细步骤
  • 15.26 开发知识-使用VNC连接中标麒麟V7操作系统
  • 15.27 开发知识-鲲鹏(ARM)麒麟操作系统如何替换yum源?
  • 15.28 开发知识-数据优化知识点
  • 15.29 水印安全-附件水印|加密|文档格式转换图片|PDF
  • 15.30 消息队列-配置activeMQ、kafka消息队列
  • 15.31 常见问题-数据导出或者导入时发生OOM异常
  • 15.32 常见问题-如何让用户在首次登录时,必须对初始密码进行修改
  • 15.33 常见问题-如何在模块部署中控制模块的访问权限
  • 15.34 常见问题-如何在平台中开发Ftp文件上传文件的服务?
  • 15.35 常见问题-如何使用服务管理调用WebService
  • 15.36 常见问题-如何使用脚本调用外部服务
  • 15.37 常见问题-如何使用脚本控制流程自动流转
  • 15.38 常见问题-如何通过脚本调用系统内服务
  • 15.39 常见问题-接口代码疑惑解答汇总
  • 15.40 常见问题:Maven编译o2server错误: Java Heap Space
  • 15.41 常见问题-集群配置后启动报错:NullPointerException
  • 15.42 常见问题-服务器错误:can not decrypt token
  • 15.43 常见问题-IOS移动办公无法收到验证码
  • 15.44 常见问题-服务器和日志时间相差12小时的问题
  • 15.45 常见问题-为什么127.0.0.1可以访问但其他IP无法访问
  • 15.46 藕粉社区问答系列4
  • 15.47 开发知识-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 9.0 (Pie) ,安装SDK。

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

    image - 2022-04-27T152517.063.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注册配置

    找到项目根目录下的 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/ 。 点击右上角控制台登录后,创建应用

    1577344559074-6b22a7ae-eb95-4d32-982c-bb1ee0a5d06a.png


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

    1577344557411-38cac163-0cd1-494c-a47e-712e16458381.png


    百度地图

    百度地图官方地址: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


    然后把这个值填入local.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服务器。

    直连版本的消息推送配置查看: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"

    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