diff --git a/README.md b/README.md index 72a96a6..24137eb 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,7 @@ [![Circle CI](https://circleci.com/gh/eggheadgames/android-about-box.svg?style=svg)](https://circleci.com/gh/eggheadgames/android-about-box) [![Release](https://jitpack.io/v/eggheadgames/android-about-box.svg)](https://jitpack.io/#eggheadgames/android-about-box) +![Downloads](https://jitpack.io/v/eggheadgames/android-about-box/month.svg) +[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/eggheadgames/android-about-box/blob/develop/LICENSE) # About Box A modern About Box for an Android App built on the [daniel-stoneuk/material-about-library](https://github.com/daniel-stoneuk/material-about-library). @@ -12,7 +14,7 @@ Android About Box is configured with a set of (mostly) strings for the company n When triggered from a menu item, it will display the app name, icon and version, provide links to contact support, leave a review, share the app, go to other apps by the same company in the app store -- as well as links to Facebook etc. -As of version 1.2.0, you can omit many features that don't apply (e.g. like website), by not setting the values. +You can omit most features if they don't apply (e.g. like website), by not setting the values. ## Installation Instructions @@ -43,6 +45,7 @@ Add AboutBox configuration to your Application class aboutConfig.appName = getString(R.string.app_name); aboutConfig.appIcon = R.mipmap.ic_launcher; aboutConfig.version = "1.0.0"; + aboutConfig.author = "Tolstoy"; aboutConfig.aboutLabelTitle = "About App"; aboutConfig.packageName = getApplicationContext().getPackageName(); aboutConfig.buildType = google ? AboutConfig.BuildType.GOOGLE : AboutConfig.BuildType.AMAZON; @@ -85,7 +88,7 @@ Add AboutBox configuration to your Application class aboutConfig.emailSubject = EMAIL_SUBJECT; aboutConfig.emailBody = EMAIL_BODY; - + ``` ## Open the About Box from your app @@ -103,6 +106,7 @@ By default, the default Android share intent will be called with the values spec aboutConfig.shareMessage = getString(R.string.share_message); aboutConfig.sharingTitle = getString(R.string.sharing_title); ``` +The `share_message` string will have an app store URL appended to it (appropriately constructed for Google Play or Amazon). Alternatively, you can provide a custom sharing function (and omit `shareMessage` and `sharingTitle`): ```java diff --git a/circle.yml b/circle.yml index ed917c0..a6eee0c 100644 --- a/circle.yml +++ b/circle.yml @@ -1,7 +1,7 @@ dependencies: pre: - echo y | android update sdk --no-ui --all --filter tools,platform-tools,android-25 - - echo y | android update sdk --no-ui --all --filter build-tools-25.0.2 + - echo y | android update sdk --no-ui --all --filter build-tools-25.0.3 test: override: diff --git a/library/build.gradle b/library/build.gradle index 33530f1..d5d552d 100644 --- a/library/build.gradle +++ b/library/build.gradle @@ -5,14 +5,14 @@ apply plugin: 'com.github.dcendents.android-maven' group='com.github.eggheadgames' android { - compileSdkVersion 24 - buildToolsVersion "25.0.2" + compileSdkVersion 25 + buildToolsVersion "25.0.3" defaultConfig { minSdkVersion 15 targetSdkVersion 24 - versionCode 4 - versionName "1.2.0" + versionCode 7 + versionName "1.3.1" } buildTypes { release { @@ -28,5 +28,5 @@ android { } dependencies { - compile 'com.github.daniel-stoneuk:material-about-library:1.8.2' + compile 'com.github.daniel-stoneuk:material-about-library:2.2.1' } diff --git a/library/src/main/java/com/eggheadgames/aboutbox/AboutBoxUtils.java b/library/src/main/java/com/eggheadgames/aboutbox/AboutBoxUtils.java index 3b5dace..32a3524 100644 --- a/library/src/main/java/com/eggheadgames/aboutbox/AboutBoxUtils.java +++ b/library/src/main/java/com/eggheadgames/aboutbox/AboutBoxUtils.java @@ -8,6 +8,9 @@ import android.widget.Toast; public final class AboutBoxUtils { + public final static String playStoreAppURI = "https://play.google.com/store/apps/details?id="; + public final static String amznStoreAppURI = "https://www.amazon.com/gp/mas/dl/android?p="; + private AboutBoxUtils() { //nothing } @@ -49,11 +52,11 @@ public final class AboutBoxUtils { switch (buildType) { case GOOGLE: appURI = "market://details?id=" + packageName; - webURI = "http://play.google.com/store/apps/details?id=" + packageName; + webURI = playStoreAppURI + packageName; break; case AMAZON: appURI = "amzn://apps/android?p=" + packageName; - webURI = "http://www.amazon.com/gp/mas/dl/android?p=" + packageName; + webURI = amznStoreAppURI + packageName; break; default: //nothing @@ -66,8 +69,17 @@ public final class AboutBoxUtils { String webURI = null; switch (buildType) { case GOOGLE: - appURI = "market://search?q=pub:" + publisher; - webURI = "http://play.google.com/store/search?q=pub:" + publisher; + // see: + // https://developer.android.com/distribute/marketing-tools/linking-to-google-play.html#OpeningPublisher + // https://stackoverflow.com/questions/32029408/how-to-open-developer-page-on-google-play-store-market + // https://issuetracker.google.com/65244694 + if (publisher.matches("\\d+")) { + webURI = "https://play.google.com/store/apps/dev?id=" + publisher; + appURI = webURI; + } else { + appURI = "market://search?q=pub:" + publisher; + webURI = "https://play.google.com/store/search?q=pub:" + publisher; + } break; case AMAZON: appURI = "amzn://apps/android?showAll=1&p=" + packageName; diff --git a/library/src/main/java/com/eggheadgames/aboutbox/AboutConfig.java b/library/src/main/java/com/eggheadgames/aboutbox/AboutConfig.java index ed456c3..4929ab6 100644 --- a/library/src/main/java/com/eggheadgames/aboutbox/AboutConfig.java +++ b/library/src/main/java/com/eggheadgames/aboutbox/AboutConfig.java @@ -8,6 +8,9 @@ public class AboutConfig { public String appName; public int appIcon; public String version; + public String author; + public String extra; + public String extraTitle; public String aboutLabelTitle; public String logUiEventName; public String facebookUserName; diff --git a/library/src/main/java/com/eggheadgames/aboutbox/activity/AboutActivity.java b/library/src/main/java/com/eggheadgames/aboutbox/activity/AboutActivity.java index 7d292dc..98555a1 100644 --- a/library/src/main/java/com/eggheadgames/aboutbox/activity/AboutActivity.java +++ b/library/src/main/java/com/eggheadgames/aboutbox/activity/AboutActivity.java @@ -8,7 +8,7 @@ import android.text.TextUtils; import com.danielstone.materialaboutlibrary.MaterialAboutActivity; import com.danielstone.materialaboutlibrary.items.MaterialAboutActionItem; -import com.danielstone.materialaboutlibrary.items.MaterialAboutItemOnClickListener; +import com.danielstone.materialaboutlibrary.items.MaterialAboutItemOnClickAction; import com.danielstone.materialaboutlibrary.items.MaterialAboutTitleItem; import com.danielstone.materialaboutlibrary.model.MaterialAboutCard; import com.danielstone.materialaboutlibrary.model.MaterialAboutList; @@ -23,6 +23,7 @@ public class AboutActivity extends MaterialAboutActivity { public static void launch(Activity activity) { Intent intent = new Intent(activity, AboutActivity.class); + intent.setFlags(Intent.FLAG_ACTIVITY_REORDER_TO_FRONT); activity.startActivity(intent); } @@ -54,6 +55,21 @@ public class AboutActivity extends MaterialAboutActivity { .text(R.string.egab_version) .subText(config.version) .build()); + + if (!TextUtils.isEmpty(config.author)) { + generalInfoCardBuilder.addItem(new MaterialAboutActionItem.Builder() + .text(R.string.egab_author) + .subText(config.author) + .build()); + } + + if (!TextUtils.isEmpty(config.extra) && !TextUtils.isEmpty(config.extraTitle)) { + generalInfoCardBuilder.addItem(new MaterialAboutActionItem.Builder() + .text(config.extraTitle) + .subTextHtml(config.extra) + .build()); + } + return generalInfoCardBuilder.build(); } @@ -63,9 +79,9 @@ public class AboutActivity extends MaterialAboutActivity { if (!TextUtils.isEmpty(config.guideHtmlPath)) { card.addItem(itemHelper(R.string.egab_guide, R.drawable.ic_help_green, - new MaterialAboutItemOnClickListener() { + new MaterialAboutItemOnClickAction() { @Override - public void onClick(boolean b) { + public void onClick() { if (config.dialog == null) { AboutBoxUtils.openHTMLPage(AboutActivity.this, config.guideHtmlPath); } else { @@ -77,9 +93,9 @@ public class AboutActivity extends MaterialAboutActivity { ); } card.addItem(itemHelper(R.string.egab_contact_support, R.drawable.ic_email_black, - new MaterialAboutItemOnClickListener() { + new MaterialAboutItemOnClickAction() { @Override - public void onClick(boolean b) { + public void onClick() { EmailUtil.contactUs(AboutActivity.this); logUIEventName(config.analytics, config.logUiEventName, getString(R.string.egab_contact_log_event)); } @@ -93,18 +109,18 @@ public class AboutActivity extends MaterialAboutActivity { MaterialAboutCard.Builder card = new MaterialAboutCard.Builder(); if (config.buildType != null && !TextUtils.isEmpty(config.packageName)) { card.addItem(itemHelper(R.string.egab_leave_review, R.drawable.ic_review, - new MaterialAboutItemOnClickListener() { + new MaterialAboutItemOnClickAction() { @Override - public void onClick(boolean b) { + public void onClick() { AboutBoxUtils.openApp(AboutActivity.this, config.buildType, config.packageName); logUIEventName(config.analytics, config.logUiEventName, getString(R.string.egab_review_log_event)); } })); } card.addItem(itemHelper(R.string.egab_share, R.drawable.ic_share_black, - new MaterialAboutItemOnClickListener() { + new MaterialAboutItemOnClickAction() { @Override - public void onClick(boolean b) { + public void onClick() { if (config.share == null) { ShareUtil.share(AboutActivity.this); } else { @@ -121,22 +137,22 @@ public class AboutActivity extends MaterialAboutActivity { MaterialAboutCard.Builder card = new MaterialAboutCard.Builder(); if (config.buildType != null && !TextUtils.isEmpty(config.appPublisher) && !TextUtils.isEmpty(config.packageName)) { card.addItem(itemHelper(R.string.egab_try_other_apps, R.drawable.ic_try_other_apps, - new MaterialAboutItemOnClickListener() { + new MaterialAboutItemOnClickAction() { @Override - public void onClick(boolean b) { + public void onClick() { AboutBoxUtils.openPublisher(AboutActivity.this, config.buildType, config.appPublisher, config.packageName); logUIEventName(config.analytics, config.logUiEventName, getString(R.string.egab_try_other_app_log_event)); } })); } - if (!TextUtils.isEmpty(config.companyHtmlPath)) { + if (!TextUtils.isEmpty(config.companyHtmlPath) && !TextUtils.isEmpty(config.aboutLabelTitle)) { card.addItem(new MaterialAboutActionItem.Builder() .text(config.aboutLabelTitle) .icon(R.drawable.ic_about_black) - .setOnClickListener(new MaterialAboutItemOnClickListener() { + .setOnClickAction(new MaterialAboutItemOnClickAction() { @Override - public void onClick(boolean b) { + public void onClick() { if (config.dialog == null) { AboutBoxUtils.openHTMLPage(AboutActivity.this, config.companyHtmlPath); } else { @@ -158,9 +174,9 @@ public class AboutActivity extends MaterialAboutActivity { .text(R.string.egab_facebook_label) .subText(config.facebookUserName) .icon(R.drawable.ic_facebook_24) - .setOnClickListener(new MaterialAboutItemOnClickListener() { + .setOnClickAction(new MaterialAboutItemOnClickAction() { @Override - public void onClick(boolean b) { + public void onClick() { AboutBoxUtils.getOpenFacebookIntent(AboutActivity.this, config.facebookUserName); logUIEventName(config.analytics, config.logUiEventName, getString(R.string.egab_facebook_log_event)); } @@ -172,9 +188,9 @@ public class AboutActivity extends MaterialAboutActivity { .text(R.string.egab_twitter_label) .subText(config.twitterUserName) .icon(R.drawable.ic_twitter_24dp) - .setOnClickListener(new MaterialAboutItemOnClickListener() { + .setOnClickAction(new MaterialAboutItemOnClickAction() { @Override - public void onClick(boolean b) { + public void onClick() { AboutBoxUtils.startTwitter(AboutActivity.this, config.twitterUserName); logUIEventName(config.analytics, config.logUiEventName, getString(R.string.egab_twitter_log_event)); } @@ -184,11 +200,11 @@ public class AboutActivity extends MaterialAboutActivity { if (!TextUtils.isEmpty(config.webHomePage)) { card.addItem(new MaterialAboutActionItem.Builder() .text(R.string.egab_web_label) - .subText(config.webHomePage.replace("https://", "").replace("http://", "").replace("/", "")) + .subText(config.webHomePage.replaceFirst("^https?://", "").replaceAll("/$", "")) .icon(R.drawable.ic_web_black_24dp) - .setOnClickListener(new MaterialAboutItemOnClickListener() { + .setOnClickAction(new MaterialAboutItemOnClickAction() { @Override - public void onClick(boolean b) { + public void onClick() { AboutBoxUtils.openHTMLPage(AboutActivity.this, config.webHomePage); logUIEventName(config.analytics, config.logUiEventName, getString(R.string.egab_website_log_event)); } @@ -203,9 +219,9 @@ public class AboutActivity extends MaterialAboutActivity { MaterialAboutCard.Builder card = new MaterialAboutCard.Builder(); if (!TextUtils.isEmpty(config.privacyHtmlPath)) { card.addItem(itemHelper(R.string.egab_privacy_policy, R.drawable.ic_privacy, - new MaterialAboutItemOnClickListener() { + new MaterialAboutItemOnClickAction() { @Override - public void onClick(boolean b) { + public void onClick() { if (config.dialog == null) { AboutBoxUtils.openHTMLPage(AboutActivity.this, config.privacyHtmlPath); } else { @@ -219,9 +235,9 @@ public class AboutActivity extends MaterialAboutActivity { } if (!TextUtils.isEmpty(config.acknowledgmentHtmlPath)) { card.addItem(itemHelper(R.string.egab_acknowledgements, R.drawable.ic_acknowledgements, - new MaterialAboutItemOnClickListener() { + new MaterialAboutItemOnClickAction() { @Override - public void onClick(boolean b) { + public void onClick() { if (config.dialog == null) { AboutBoxUtils.openHTMLPage(AboutActivity.this, config.acknowledgmentHtmlPath); } else { @@ -235,11 +251,11 @@ public class AboutActivity extends MaterialAboutActivity { return card.build(); } - private MaterialAboutActionItem itemHelper(int name, int icon, MaterialAboutItemOnClickListener listener) { + private MaterialAboutActionItem itemHelper(int name, int icon, MaterialAboutItemOnClickAction clickAction) { return new MaterialAboutActionItem.Builder() .text(name) .icon(icon) - .setOnClickListener(listener) + .setOnClickAction(clickAction) .build(); } diff --git a/library/src/main/java/com/eggheadgames/aboutbox/share/ShareUtil.java b/library/src/main/java/com/eggheadgames/aboutbox/share/ShareUtil.java index 61a4511..95c59a9 100644 --- a/library/src/main/java/com/eggheadgames/aboutbox/share/ShareUtil.java +++ b/library/src/main/java/com/eggheadgames/aboutbox/share/ShareUtil.java @@ -2,7 +2,9 @@ package com.eggheadgames.aboutbox.share; import android.app.Activity; import android.content.Intent; +import android.text.TextUtils; +import com.eggheadgames.aboutbox.AboutBoxUtils; import com.eggheadgames.aboutbox.AboutConfig; public final class ShareUtil { @@ -17,7 +19,24 @@ public final class ShareUtil { Intent intent2 = new Intent(); intent2.setAction(Intent.ACTION_SEND); intent2.setType("text/plain"); - intent2.putExtra(Intent.EXTRA_TEXT, config.shareMessage); + + String shareMessage = config.shareMessage; + + if (!TextUtils.isEmpty(config.packageName) && !TextUtils.isEmpty(shareMessage) && config.buildType != null) { + switch (config.buildType) { + case GOOGLE: + shareMessage = shareMessage + AboutBoxUtils.playStoreAppURI + config.packageName; + break; + case AMAZON: + shareMessage = shareMessage + AboutBoxUtils.amznStoreAppURI + config.packageName; + break; + default: + break; + } + } + + intent2.putExtra(Intent.EXTRA_TEXT, shareMessage); + activity.startActivity(Intent.createChooser(intent2, config.sharingTitle)); } } diff --git a/library/src/main/res/values-pt/strings.xml b/library/src/main/res/values-pt/strings.xml index 0e6a643..18a0b23 100644 --- a/library/src/main/res/values-pt/strings.xml +++ b/library/src/main/res/values-pt/strings.xml @@ -3,6 +3,7 @@ Contactar o Suporte Experimentar outras aplicações Versão + Autor Facebook Twitter Web diff --git a/library/src/main/res/values/strings.xml b/library/src/main/res/values/strings.xml index b979e55..894f9ae 100644 --- a/library/src/main/res/values/strings.xml +++ b/library/src/main/res/values/strings.xml @@ -3,6 +3,7 @@ Contact Support Try Other Apps Version + Author Facebook Twitter Web diff --git a/library/src/main/res/values/styles.xml b/library/src/main/res/values/styles.xml index 41c850f..d0590ed 100644 --- a/library/src/main/res/values/styles.xml +++ b/library/src/main/res/values/styles.xml @@ -1,7 +1,7 @@ -