From c58f97452e3b5e4c9bbde5ee39bb135fd34cf593 Mon Sep 17 00:00:00 2001
From: Amine <aminecmi@gmail.com>
Date: Wed, 6 Sep 2017 21:16:20 +0200
Subject: [PATCH] Fixed issues with secrets xml file. Removed it and remplaced
 with build config.

---
 .github/CONTRIBUTING.md                       |  32 ++++++++++++++----
 .gitignore                                    |   2 --
 CHANGELOG.md                                  |   4 +++
 app/build.gradle                              |  19 +++++++++++
 .../apps/amine/bou/readerforselfoss/MyApp.kt  |   2 +-
 .../bou/readerforselfoss/ReaderActivity.kt    |   2 +-
 .../settings/SettingsActivity.java            |   5 +--
 secrets.tar.enc                               | Bin 10256 -> 0 bytes
 8 files changed, 53 insertions(+), 13 deletions(-)
 delete mode 100644 secrets.tar.enc

diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md
index e43235d..5259427 100644
--- a/.github/CONTRIBUTING.md
+++ b/.github/CONTRIBUTING.md
@@ -46,12 +46,30 @@ You can directly import this project into IntellIJ/Android Studio.
 
 You'll have to:
 
-- Configure Fabric, or [remove it](https://docs.fabric.io/android/fabric/settings/removing.html#).
+- Configure fabric and add your `apiKey` and `apiSecret` in the `fabric.properties` file.
 - Create a firebase project and add the `google-services.json` to the `app/` folder.
-- Define the following in `res/values/strings.xml` or create `res/values/secrets.xml`
+- Define the following some parameters either in `~/.gradle/gradle.properties` or as gradle parameters (see the examples)
 
-    - mercury: A [Mercury](https://mercury.postlight.com/web-parser/) web parser api key for the internal browser
-    - feedback_email: An email to receive users  feedback.
-    - source_url: an url to the source code, used in the settings
-    - tracker_url: an url to the tracker, used in the settings
-- To run your app, you'll have to add `-P appLoginUrl="your.selfoss-instance.url" -P appLoginUsername="Username" -P appLoginPassword="password"`. (These are only used to run the espresso tests. You should be able to use empty strings or fake values to build the app)
+    - mercuryApiKey: A [Mercury](https://mercury.postlight.com/web-parser/) web parser api key for the internal browser
+    - feedbackEmail: An email to receive users  feedback.
+    - sourceUrl: an url to the source code, used in the settings
+    - trackerUrl: an url to the tracker, used in the settings
+
+### Examples:
+#### Inside ~/.gradle/gradle.properties
+
+```
+appLoginUrl="URL"
+appLoginUsername="LOGIN"
+appLoginPassword="PASS"
+mercuryApiKey="LONGAPIKEY"
+feedbackEmail="EMAIL"
+sourceUrl="URLSOURCE"
+trackerUrl="URLTRACKER"
+```
+
+#### As gradle parameters
+
+```
+./gradlew .... -P appLoginUrl="URL" -P appLoginUsername="LOGIN" -P appLoginPassword="PASS" -P mercuryApiKey="LONGAPIKEY" -P feedbackEmail="EMAIL" -P sourceUrl="URLSOURCE" -P trackerUrl="URLTRACKER"
+```
diff --git a/.gitignore b/.gitignore
index ad7be5c..66ca69c 100644
--- a/.gitignore
+++ b/.gitignore
@@ -214,6 +214,4 @@ gradle-app.setting
 
 # End of https://www.gitignore.io/api/java,gradle,android,androidstudio
 
-secrets.xml
-
 release/
\ No newline at end of file
diff --git a/CHANGELOG.md b/CHANGELOG.md
index cc11917..1629f4f 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,7 @@
+**1.5.2.17**
+
+- Source code and tracker links weren't being set, and updated the contributing doc.
+
 **1.5.2.15/16**
 
 - Adding an account header on the lateral drawer.
diff --git a/app/build.gradle b/app/build.gradle
index 3c6490e..5dfb613 100644
--- a/app/build.gradle
+++ b/app/build.gradle
@@ -53,6 +53,11 @@ android {
 
         // tests
         testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
+
+        buildConfigField "String", "MERCURY_KEY", mercuryApiKey
+        buildConfigField "String", "FEEDBACK_EMAIL", feedbackEmail
+        buildConfigField "String", "SOURCE_URL", sourceUrl
+        buildConfigField "String", "TRACKER_URL", trackerUrl
     }
     buildTypes {
         release {
@@ -165,6 +170,7 @@ apply plugin: 'com.google.gms.google-services'
 afterEvaluate {
     initFabricPropertiesIfNeeded()
     initAppLoginPropertiesIfNeeded()
+    initAppForSecretPropertiesIfNeeded()
 }
 
 def initFabricPropertiesIfNeeded() {
@@ -189,3 +195,16 @@ def initAppLoginPropertiesIfNeeded() {
         }
     }
 }
+
+def initAppForSecretPropertiesIfNeeded() {
+    def propertiesFile = file(System.getProperty("user.home") + '/.gradle/gradle.properties')
+    if (!propertiesFile.exists()) {
+        def commentMessage = "This is autogenerated local property from system environment to prevent key to be committed to source control."
+        ant.propertyfile(file: System.getProperty("user.home") + "/.gradle/gradle.properties", comment: commentMessage) {
+            entry(key: "mercuryApiKey", value: System.getProperty("mercuryApiKey"))
+            entry(key: "feedbackEmail", value: System.getProperty("feedbackEmail"))
+            entry(key: "sourceUrl", value: System.getProperty("sourceUrl"))
+            entry(key: "trackerUrl", value: System.getProperty("trackerUrl"))
+        }
+    }
+}
diff --git a/app/src/main/java/apps/amine/bou/readerforselfoss/MyApp.kt b/app/src/main/java/apps/amine/bou/readerforselfoss/MyApp.kt
index 8b882c3..f159ba2 100644
--- a/app/src/main/java/apps/amine/bou/readerforselfoss/MyApp.kt
+++ b/app/src/main/java/apps/amine/bou/readerforselfoss/MyApp.kt
@@ -49,7 +49,7 @@ class MyApp : MultiDexApplication() {
 
     private fun initAmplify() {
         Amplify.initSharedInstance(this)
-            .setFeedbackEmailAddress(getString(R.string.feedback_email))
+            .setFeedbackEmailAddress(BuildConfig.FEEDBACK_EMAIL)
             .applyAllDefaultRules()
     }
 
diff --git a/app/src/main/java/apps/amine/bou/readerforselfoss/ReaderActivity.kt b/app/src/main/java/apps/amine/bou/readerforselfoss/ReaderActivity.kt
index 59b62d4..c91c0b3 100644
--- a/app/src/main/java/apps/amine/bou/readerforselfoss/ReaderActivity.kt
+++ b/app/src/main/java/apps/amine/bou/readerforselfoss/ReaderActivity.kt
@@ -51,7 +51,7 @@ class ReaderActivity : DragDismissActivity() {
         val title: TextView = v.findViewById(R.id.title)
         val content: HtmlTextView = v.findViewById(R.id.content)
         val url = intent.getStringExtra("url")
-        val parser = MercuryApi(getString(R.string.mercury))
+        val parser = MercuryApi(BuildConfig.MERCURY_KEY)
         val browserBtn: ImageButton = v.findViewById(R.id.browserBtn)
         val shareBtn: ImageButton = v.findViewById(R.id.shareBtn)
 
diff --git a/app/src/main/java/apps/amine/bou/readerforselfoss/settings/SettingsActivity.java b/app/src/main/java/apps/amine/bou/readerforselfoss/settings/SettingsActivity.java
index 07df4d4..1712917 100644
--- a/app/src/main/java/apps/amine/bou/readerforselfoss/settings/SettingsActivity.java
+++ b/app/src/main/java/apps/amine/bou/readerforselfoss/settings/SettingsActivity.java
@@ -27,6 +27,7 @@ import android.widget.Toast;
 
 import java.util.List;
 
+import apps.amine.bou.readerforselfoss.BuildConfig;
 import apps.amine.bou.readerforselfoss.R;
 import apps.amine.bou.readerforselfoss.utils.Config;
 import com.ftinc.scoop.ui.ScoopSettingsActivity;
@@ -242,7 +243,7 @@ public class SettingsActivity extends AppCompatPreferenceActivity {
             findPreference( "trackerLink" ).setOnPreferenceClickListener(new Preference.OnPreferenceClickListener() {
                 @Override
                 public boolean onPreferenceClick(Preference preference) {
-                    openUrl(Uri.parse(getString(R.string.tracker_url)));
+                    openUrl(Uri.parse(BuildConfig.TRACKER_URL));
                     return true;
                 }
             });
@@ -250,7 +251,7 @@ public class SettingsActivity extends AppCompatPreferenceActivity {
             findPreference("sourceLink").setOnPreferenceClickListener(new Preference.OnPreferenceClickListener() {
                 @Override
                 public boolean onPreferenceClick(Preference preference) {
-                    openUrl(Uri.parse(getString(R.string.source_url)));
+                    openUrl(Uri.parse(BuildConfig.SOURCE_URL));
                     return false;
                 }
             });
diff --git a/secrets.tar.enc b/secrets.tar.enc
deleted file mode 100644
index b3ca8b459a4f731a71c320cad435ef09828a12e7..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 10256
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
W*}NlYavaJOF=O~?RY>WuA1CJ$Y4<Sz