分享一个APP的制作教程(教程来自互联网自行研究!)
技术要求
准备
使用并安装Android studio
1. 修改应用名称
[backcolor=var(--comiis-bgc)]
[color=var(--comiis-color) !important]复制代码
国际化需求
[backcolor=var(--comiis-bgc)]
[color=var(--comiis-color) !important]复制代码
2. 修改应用ID
[backcolor=var(--comiis-bgc)]
[color=var(--comiis-color) !important]复制代码
这样你就完成了applicationId的修改。
修改构建类型的值
在项目的gradle文件(相对路径:app/build.gradle)下,我们提供了不同的构建类型,其对应着不同的分发版本,有着不同的功能
请修改single下的discuz_title以及discuz_base_url两个值。
[backcolor=var(--comiis-bgc)]
[color=var(--comiis-color) !important]复制代码
更换图标
准备图标
使用Android Studio导入
从Manifest中更改图标
请在AndroidManifest.xml(路径:app\src\main\AndroidManifest.xml)文件中,修改application目录下的android:icon这个值为您论坛的名称。如果是位图则是@drawable/刚刚生成的名字,如果是像素则是@mipmap/刚刚生成的名字
[backcolor=var(--comiis-bgc)]
[color=var(--comiis-color) !important]复制代码
我们建议使用位图图像,如果你想省事的话,直接复制PNG图片,替换mipmap下的logo.png(路径:/app/src/main/res/mipmap-xxxhdpi/logo.png)文件即可
构建应用
生成应用
选择密钥库
选择构建类型
你需要达到以下要求以完成对于专属应用的编译以及发布
- 一台支持Android studio的计算机Android studio(大陆地区可以使用Google.cn开发者网站下载[color=var(--theme-ui-colors-primary)]https://developer.android.google.cn/studio)
准备
首先,你需要下载Discuz Hub源代码。
源码地址:https://gitee.com/vez12/DiscuzHub
将下载的源代码(文件名可能是DiscuzHub-master.zip)解压到您存放源代码的文件夹
这样你就完成了对于源代码的下载。接着你需要开始使用Android studio这个官方IDE编译此应用。
使用并安装Android studio
从[color=var(--theme-ui-colors-primary)]Android studio(大陆地区[color=var(--theme-ui-colors-primary)]https://developer.android.google.cn/studio)安装好应用后,你可能需要设置或下载一系列的软件和插件以能够编译Android应用。
我们的工程目前是支持Android 11版本的,请选择并下载此版本的SDK以完成编译。
使用Android studio打开存放源代码的文件夹。
1. 修改应用名称
请在AndroidManifest.xml(路径:app\src\main\AndroidManifest.xml)文件中,修改application目录下的android:label这个值为您论坛的名称。例如android:label="QZZN论坛"
[backcolor=var(--comiis-bgc)]
- <application android:allowBackup="true" android:icon="@mipmap/logo" android:label="QZZN论坛" android:networkSecurityConfig="@xml/network_security_config" android:supportsRtl="true" android:theme="@style/AppTheme.Default" tools:ignore="GoogleAppIndexingWarning" tools:targetApi="n">
[color=var(--comiis-color) !important]复制代码
国际化需求
我们理解到部分论坛可能具有国际化任务的需求,那么请维持AndroidManifest.xml文件的android:label这个值,转而修改string.xml文件的app_name这个值。我们谨以keylol.com为例子。
keylol.com中文名称为其乐,英文名称为keylol。
在默认英文字符串文件(strings.xml,路径app\src\main\res\values\strings.xml)中修改app_name为keylol,在中文字符串文件(src\main\res\values-zh-rCN\strings.xml)中修改app_name值为其乐。
[backcolor=var(--comiis-bgc)]
- <application android:allowBackup="true" android:icon="@mipmap/logo" android:label="@string/app_name" android:networkSecurityConfig="@xml/network_security_config" android:supportsRtl="true" android:theme="@style/AppTheme.Default" tools:ignore="GoogleAppIndexingWarning" tools:targetApi="n">
[color=var(--comiis-color) !important]复制代码
2. 修改应用ID
应用ID相当于应用的身份证,一个应用应当只有一个ID。当相同的ID安装时,将会发生覆盖的情况,并且会干扰应用的运行。根据我们的使用条款且为了您的分发便利,您不应当使用我们的应用ID而应当转而使用自己的ID。我们以QZZN为例,其论坛使用的域名为bbs.qzzn.com,那么根据Google开发者指南推荐,你可以使用com.qzzn.bbs为应用ID。
在模块的Gradle文件中,修改android选项下的defaultConfig中的applicationId为 "com.qzzn.bbs" ,示例如下:
[backcolor=var(--comiis-bgc)]
- android { compileSdkVersion 30 buildToolsVersion "29.0.3" defaultConfig { applicationId "com.qzzn.bbs" minSdkVersion 23 targetSdkVersion 30 versionCode 31 versionName "3.10" testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner" manifestPlaceholders = [ discuz_title: "NOT_IMPLEMENTED", discuz_base_url: "NOT_IMPLEMENTED", ] } ...}
[color=var(--comiis-color) !important]复制代码
这样你就完成了applicationId的修改。
修改构建类型的值
在项目的gradle文件(相对路径:app/build.gradle)下,我们提供了不同的构建类型,其对应着不同的分发版本,有着不同的功能
- single:这个就是专属论坛使用的构建类型,在分发时,您应当选择此构建类型构建自己的应用并分发release: 这个是我们分发Discuz Hub应用时的构建源,其支持多个论坛同时使用,这个不应当用于构建专属论坛。debug:调试内容,这个不应用于生产环境qzzn:一个以qzzn论坛为例的构建类型
请修改single下的discuz_title以及discuz_base_url两个值。
[backcolor=var(--comiis-bgc)]
- single { // fill your bbs id manifestPlaceholders = [ discuz_title: "论坛名称(如:西北工业大学三行四方)", discuz_base_url: "服务网址(如:https://bbs.example.com)", ] proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro' applicationIdSuffix ".bbs" }
[color=var(--comiis-color) !important]复制代码
- discuz_title是论坛的名称,其将会被显示与开始页面,最终存入数据库的名称将以API为准discuz_base_url是论坛的网址,这个参数非常重要,有的论坛服务在域名上(如bbs.qzzn.com),有的论坛则有一个路径(如一亩三分地: [color=var(--theme-ui-colors-primary)]www.1point3acres.com/bbs),你应当非常注意此值。同时网址也需要给上协议(如HTTP和HTTPS)。我们的应用虽然支持跳转,但是当你的论坛支持HTTPS协议时,请不要使用HTTP协议。applicationIdSuffix会在最终的applicationId添加一个 .bbs 的后缀,因此最终编译出的applicationId将会是com.qzzn.bbs.bbs
这样就完成了应用的修改,接着就可以开始应用的构建了。
更换图标
根据我们的使用政策,您不应当使用我们的图标来分发您的应用。因此,您需要使用自己的图标。
准备图标
我们推荐您使用SVG位图或者PNG、JPG等像素图像作为应用图标,尺寸大小应当是一个正方形或者类正方形。
| | SVG | PNG、JPG | | ---- | ---- | ---- | | 性质 | 位图 | 像素图 | | 分辨率 | 接近于无限,极好 | 较差 | | 兼容性 | 差,尤其是多图层、图形复杂时 | 好 |
我们理解到部分应用商店(例如小米应用商店)要求图标是PNG格式,因此请根据您的分发渠道确定图标格式。
使用Android Studio导入
在项目框中任一地方点击右键,呼出对话框。如果是位图SVG文件,选择New -> Vector Asset,如果是PNG、JPG资源文件选择New -> Image Asset。
接下来选择你准备好的图片资源,选择好后,选择尺寸(建议100×100)
点击next完成
从Manifest中更改图标
请在AndroidManifest.xml(路径:app\src\main\AndroidManifest.xml)文件中,修改application目录下的android:icon这个值为您论坛的名称。如果是位图则是@drawable/刚刚生成的名字,如果是像素则是@mipmap/刚刚生成的名字
[backcolor=var(--comiis-bgc)]
- <application android:allowBackup="true" android:icon="@mipmap/logo" android:label="@string/app_name" android:networkSecurityConfig="@xml/network_security_config" android:supportsRtl="true" android:theme="@style/AppTheme.Default" tools:ignore="GoogleAppIndexingWarning" tools:targetApi="n">
[color=var(--comiis-color) !important]复制代码
我们建议使用位图图像,如果你想省事的话,直接复制PNG图片,替换mipmap下的logo.png(路径:/app/src/main/res/mipmap-xxxhdpi/logo.png)文件即可
构建应用
和正常的Android程序一样,首先你需要使用gradle构建一下整个项目。在导航栏中选择Build->Make Project完成项目的构建。
生成应用
在导航栏中选择Build->Generate Signed Bundle or APK,打开选中的框
选择你需要分发的应用类型,我们以分发APK为例,选择APK,点击Next。
选择密钥库
当你首次生成安装文件时,你需要创建一个密钥库(keystore)对安装包进行加密,并验证你的身份。如果你之前有密钥库,你可以选择Choose exisiting以选择密钥库。
若你没有密钥库,请选择Create New以创建新的密钥库。
填上上面的信息后,相应路径下就会生成密钥库文件。
选择密钥库并填上密钥和密码,点击Next。
选择构建类型
请选择single,构建专属于您论坛的应用。建议同时选择上签名版本v1和v2。点击finish开始生成安装包apk。
等待生成完毕后,生成的APK文件就可以用于分发以及安装。
这样,你就完成了应用的构建