# o2oa-android **Repository Path**: o2oa/o2oa-android ## Basic Information - **Project Name**: o2oa-android - **Description**: O2OA（翱途） 开源OA企业信息化平台 Android源码 - **Primary Language**: Unknown - **License**: AGPL-3.0 - **Default Branch**: master - **Homepage**: http://www.o2oa.net - **GVP Project**: No ## Statistics - **Stars**: 72 - **Forks**: 168 - **Created**: 2020-12-02 - **Last Updated**: 2025-06-20 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # O2OA 企业信息化办公平台 Android端源码 O2OA 平台Android客户端，最低支持Android版本5.0 Android L，编程语言主要使用kotlin。 ## 环境安装 请使用最新版本的`Android Studio`进行导入编译，编译的Android SDK版本是 30。 `Android Studio`下载地址https://developer.android.google.cn/studio/ 安装Android Studio完成后，打开设置里面的SDK Manager工具。 ![image](./img/1577344557429-5f5242d4-89b0-426e-bf59-057a2e52686f.png) 选择**Android 12.0 (S)** ，安装SDK。 ![image.png](./img/20221125-sdk.png) 然后选择SDK Tools 选项卡，勾选右下角的Show Package Details，然后选择Android SDK Build-Tools 下面的**30.0.3**版本进行安装。 ![image.png](./img/2022-03-31_10.17.07.png) ## 导入项目 打开`Android Studio` 点击`Open an existing Android Studio project` ![image](./img/1577344557509-a21b55b1-4241-4b5a-b642-aa6c74c8e549.png) 等它加载完成后可能会弹出这样一个窗口，让你更新gradle版本，这个不需要更新，点击 `Donot remind me again for this project` ![image](./img/1577344558957-4a1ed875-17de-4d35-9a53-1fc14de8caff.png) ## 项目基本信息修改 ### 项目名称 项目名称就是Android手机桌面上显示的名称，这个名称修改是在strings资源文件中： 具体位置：`./app/src/main/res/values/strings.xml` ![image](./img/1577344557451-0d30193a-801c-43bd-94a5-b60ac07773a5.png) ### 项目桌面LOGO 还有就是项目的LOGO，这个LOGO是在Android手机桌面上显示那个图标，这个需要替换图片： 图片位置： `./app/src/main/res` 这个资源目录下有4个 `mipmap` 文件夹，把4个文件夹中的`logo.png`和`logo_round.png`都替换了。 | | | | ------------------------------------------------------------ | ------------------------------------------------------------ | | ![image](./img/1577344557413-0780e7c6-8597-4239-a47a-b2aef0b879dc.png) | ![image](./img/1577344557674-0bc05c23-9c26-409c-b2e4-5f16f92e7f8b.png) | ### 唯一应用ID Android应用都有一个唯一的应用ID `applicationId` 。这个id代表这个Android App所以不能重复，一般都用公司域名组成的一串字符串，如： `com.baidu.app.xxx` 。 修改的文件是在`./app/build.gradle` 文件中，android -> defaultConfig -> applicationId 。 ![image](./img/1577344557438-dee08395-93fd-427a-86be-871cc8701316.png) ### 可配置的应用内图标 App内看到的一些O2OA相关的logo图标，可以不编译打包进App，我们服务端可以进行动态配置。用管理员进入我们O2OA的服务端，找到系统设置->移动办公配置->样式配置，就可以修改图标了： ![image](./img/20221125-image-style.png) ## 第三方SDK配置 找到项目根目录下的 gradle.properties 文件，里面有一些第三方SDK的key需要配置。 #下面是第三方SDK 需要的key #极光推送 JPUSH_APPKEY_DEBUG=极光推送AppKey #百度地图 BAIDU_MAP_APPKEY=百度地图Appkey 在`local.properties`文件中还有打包签名证书的信息需要配置，如果用Android studio打包，这几个参数可为空： ``` signingConfig.keyAlias=密钥别名 signingConfig.keyPassword=密码 signingConfig.storeFilePath=密钥文件 signingConfig.storePassword=存储密码 ``` ## 直连版本配置 如果你不希望连接到我们O2云，通过修改配置编译打包，生成的Android应用，就会直接连接到你们自己的O2OA服务器。 直连版本的极光消息推送需要额外配置：[《O2OA移动端APP直连版本如何开启消息推送》](https://www.yuque.com/o2oa/cfst8l/mws5lw) 修改方式如下： 在app目录下的build.gradle文件中，找到 android -> buildTypes ，把`InnerServer` 改成 `true` 。这里应用有两个 一个debug下的 一个是release下的 buildConfigField "Boolean", "InnerServer", "true" ![image](./img/1577344559312-11600328-394a-4b1a-8798-b85c1af59219.png) 然后找到app->assets 目录下找到server.json文件，把里面的centerHost 、 centerPort、httpProtocol改成你们自己的O2OA中心服务器地址信息。 ![image](./img/1577344559030-1735ff15-8980-42cf-a8c8-220d9d8ff200.png) ## 打包Android apk 打包还是通过Android Studio工具。上面提到的生成签名文件的时候一样，找到菜单 Build -> Generate Signed Bundle or APK 。 ![image](./img/1577344557829-5b7d13c2-9b8c-4743-abb6-b7df21af84f9.png) 然后勾选APK ，下一步。 ![image](./img/1577344558176-f5c3d53c-4483-4070-9164-49de977ef72e.png) 这次不用新建了因为刚才已经创建好签名文件了，选择你刚才生成的签名文件，输入密码，然后继续。 ![image](./img/1577344558020-ea1b6356-e766-4b1f-a7f6-eff15dae770f.png) 这里的签名版本V1和V2都勾选。点击 `Finish` 就开始打包了。 打包完成后，APK文件在 `./app/O2PLATFORM/release/` 目录下 。 # 协议 [AGPL-3.0 开源协议。](./LICENSE) # 关于 [![img](./img/O2OA-logo.jpg)](./img/O2OA-logo.jpg) O2OA开发平台是由 **浙江兰德纵横网路技术股份有限公司** 建立和维护的。O2OA 的名字和标志是属于 **浙江兰德纵横网路技术股份有限公司** 的注册商标。 我们 ❤️ 开源软件！看一下[我们的其他开源项目](https://github.com/o2oa)，瞅一眼[我们的博客](https://my.oschina.net/o2oa)。