SettingsMain: Push server introduction

Signed-off-by: Fung <fython@163.com>

Author: fython

mobile/barcode_scan.xml

@@ -7,10 +7,11 @@ import kotlin.properties.Delegates
 class PTSettings(context: Context): SharedPreferencesProvider(context, "settings") {
 
 	var enablePush by booleanValue(defValue = false)
-	var pushApiHost by stringValue(defValue = "pt.api.rabi.coffee")
+	var pushApiHost by stringValue()
 	var pushApiPort by intValue(defValue = 3000)
 
 	var shouldShowTips by booleanValue(defValue = true)
+	var clickedDonate by booleanValue(defValue = false)
 
 }
 

mobile/src/main/kotlin/info/papdt/express/helper/support/PTSettings.kt

@@ -43,6 +43,7 @@ class SettingsMain : AbsPrefFragment(), Preference.OnPreferenceClickListener, Pr
 	private val mPrefInstanceId: Preference by PreferenceProperty("firebase_instance_id")
 	private val mPrefSync: Preference by PreferenceProperty("push_sync")
 	private val mPrefReqPush: Preference by PreferenceProperty("request_push")
+	private val mPrefWhatsThis: Preference by PreferenceProperty("push_intro")
 
 	// Auto detect
 	private val mPrefFromClipboard: SwitchPreference by PreferenceProperty("from_clipboard")
@@ -59,6 +60,7 @@ class SettingsMain : AbsPrefFragment(), Preference.OnPreferenceClickListener, Pr
 	private val mPrefContributors: Preference by PreferenceProperty("contributors")
 
 	private var needRegister = false
+	private var needFreeServer = false
 
 	private val database by lazy { PackageDatabase.getInstance(activity) }
 
@@ -136,6 +138,7 @@ class SettingsMain : AbsPrefFragment(), Preference.OnPreferenceClickListener, Pr
 		mPrefEnable.onPreferenceChangeListener = this
 		mPrefApiHost.onPreferenceChangeListener = this
 		mPrefApiPort.onPreferenceChangeListener = this
+		mPrefWhatsThis.onPreferenceClickListener = this
 
 		// Auto detect
 		mPrefFromClipboard.onPreferenceChangeListener = this
@@ -167,6 +170,13 @@ class SettingsMain : AbsPrefFragment(), Preference.OnPreferenceClickListener, Pr
 		)
 	}
 
+	private fun setFreeApiServer() {
+		mPrefApiHost.text = "pt.api.rabi.coffee"
+		mPrefApiPort.text = "3000"
+		SettingsInstance.pushApiHost = "pt.api.rabi.coffee"
+		SettingsInstance.pushApiPort = 3000
+	}
+
 	override fun onPreferenceClick(pref: Preference): Boolean {
 		return when (pref) {
 			// UI
@@ -220,6 +230,25 @@ class SettingsMain : AbsPrefFragment(), Preference.OnPreferenceClickListener, Pr
 				} else PushApi.requestPush().subscribe { makeSnackbar(it.message, Snackbar.LENGTH_LONG).show() }
 				true
 			}
+			mPrefWhatsThis -> {
+				activity.buildAlertDialog {
+					titleRes = R.string.fcm_push_intro_title
+					messageRes = R.string.fcm_push_intro_msg
+					okButton()
+					neutralButton(R.string.fcm_push_no_server_button) { _, _ ->
+						if (SettingsInstance.clickedDonate) {
+							setFreeApiServer()
+						} else {
+							needFreeServer = true
+							activity.buildAlertDialog {
+								messageRes = R.string.no_server_message
+								okButton()
+							}.show()
+						}
+					}
+				}.show()
+				true
+			}
 			// Auto detect
 			mPrefFromScreen -> {
 				startActivity(Intent(android.provider.Settings.ACTION_ACCESSIBILITY_SETTINGS))
@@ -242,6 +271,8 @@ class SettingsMain : AbsPrefFragment(), Preference.OnPreferenceClickListener, Pr
 					makeSnackbar(getString(R.string.toast_copied_successfully), Snackbar.LENGTH_SHORT)
 							.show()
 				}
+				SettingsInstance.clickedDonate = true
+				if (needFreeServer) setFreeApiServer()
 				true
 			}
 			mPrefLicense -> {

mobile/src/main/kotlin/info/papdt/express/helper/ui/fragment/settings/SettingsMain.kt

@@ -140,6 +140,16 @@
 	<string name="pref_api_host">服务器地址</string>
 	<string name="pref_api_port">服务器端口</string>
 	<string name="pref_request_push">立即请求推送</string>
+	<string name="pref_whats_this">这是什么？</string>
+	<string name="fcm_push_intro_title">基于 FCM 推送服务</string>
+	<string name="fcm_push_intro_msg">我们通过 Firebase 云通知提供了一个更高效的途径来拉取包裹信息。
+		你可以在自己的服务器上运行水表助手推送服务，然后设置到客户端中。
+		\n\n客户端将会和服务器同步列表。当新的信息来临时，服务器会通过 FCM 推送通知（客户端需要 Google 服务框架）。
+		\n\n推送服务源代码 (Node.js) 已经发布在 GitHub。你可以将它下载下来并运行在你的服务器中。
+		\nGitHub: https://github.com/fython/PackageTracker-NodeServer
+	</string>
+	<string name="fcm_push_no_server_button">没有服务器？</string>
+	<string name="no_server_message">点击 \"通过支付宝捐赠\" 设置后，你可以使用我的自建服务器。</string>
 
 	<string name="item_notification_do_not_disturb">勿扰模式</string>
 	<string name="item_notification_do_not_disturb_desc">在 23:00 到次日 06:00 期间不发出通知。</string>

mobile/src/main/res/values-zh-rCN/strings.xml

@@ -140,6 +140,16 @@
 	<string name="pref_api_host">伺服器地址</string>
 	<string name="pref_api_port">伺服器端口</string>
 	<string name="pref_request_push">立即請求推送</string>
+	<string name="pref_whats_this">這是什麼？</string>
+	<string name="fcm_push_intro_title">基於 FCM 推送服務</string>
+	<string name="fcm_push_intro_msg">我們通過 Firebase 雲通知提供了一個更高效的途徑來獲取包裹資料。
+		你可以在自己的伺服器上運行水錶助手推送服務，然後設定到客戶端中。
+		\n\n客戶端將會與伺服器同步清單。當新的訊息來臨時，伺服器会通過 FCM 推送通知（客戶端需要 Google 服務框架）。
+		\n\n推送服務程式源代碼 (Node.js) 已經發佈在 GitHub。你可以將它下載下來並運行在你的伺服器中。
+		\nGitHub: https://github.com/fython/PackageTracker-NodeServer
+	</string>
+	<string name="fcm_push_no_server_button">沒有伺服器？</string>
+	<string name="no_server_message">點擊 \"通過支付寶捐贈\" 設定後，你可以使用我的自建伺服器。</string>
 
 	<string name="item_notification_do_not_disturb">勿擾模式</string>
 	<string name="item_notification_do_not_disturb_desc">在 23:00 至次日 06:00 期間不發出通知。</string>

mobile/src/main/res/values-zh-rTW/strings.xml

@@ -169,6 +169,16 @@
 	<string name="pref_api_host">Server host</string>
 	<string name="pref_api_port">Server port</string>
 	<string name="pref_request_push">Request push now</string>
+	<string name="pref_whats_this">What\'s this?</string>
+	<string name="fcm_push_intro_title">FCM-Based Push Service</string>
+	<string name="fcm_push_intro_msg">We provide a more effective way to pull the latest status of packages with Firebase Cloud Messaging.
+		You can run Package Tracker Push Server in your own server and set up in client.
+		\n\nClient will synchronize list to the server. When new status come up, server will push notification through FCM, which is more power-saving push service built in Google Service.
+		\n\nPush Server source code (Node.js) has been published to GitHub. You can download it and run in your own server.
+		\nGitHub: https://github.com/fython/PackageTracker-NodeServer
+	</string>
+	<string name="fcm_push_no_server_button">I don\'t have a server</string>
+	<string name="no_server_message">After clicking \"Donate via Alipay\" in settings, you can use my server.</string>
 
 	<string name="item_notification_do_not_disturb">Do not disturb mode</string>
 	<string name="item_notification_do_not_disturb_desc">Don\'t send notifications from 23:00 to 06:00.</string>

mobile/src/main/res/values/strings.xml

@@ -61,6 +61,8 @@
 
 		<Preference android:key="request_push" android:title="@string/pref_request_push"/>
 
+		<Preference android:key="push_intro" android:title="@string/pref_whats_this"/>
+
 	</PreferenceCategory>
 
 	<PreferenceCategory android:title="@string/category_auto_detect_services">

mobile/src/main/res/xml/settings_main.xml

@@ -61,6 +61,8 @@
 
 		<Preference android:key="request_push" android:title="@string/pref_request_push"/>
 
+		<Preference android:key="push_intro" android:title="@string/pref_whats_this"/>
+
 	</PreferenceCategory>
 
 	<PreferenceCategory android:title="@string/category_auto_detect_services">