分享一個APP的制作教程（教程來自互聯網自行研究！）

林子浩

技術要求

你需要達到以下要求以完成對于專屬應用的編譯以及發布

• 一臺支持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文件就可以用于分發以及安裝。

這樣，你就完成了應用的構建

ji8123

特意登入給你點贊