mirror of
https://github.com/ethauvin/android-about-box.git
synced 2025-04-25 02:37:11 -07:00
Merge pull request #27 from eggheadgames/release_1.2.0
Update Readme file
This commit is contained in:
commit
e8e817ed30
2 changed files with 28 additions and 16 deletions
42
README.md
42
README.md
|
@ -12,7 +12,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.
|
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.1.0, you can also optionally provide a help file with the `aboutConfig.guideHtmlPath` setting. Leave it unset (null or empty string) and the behaviour is compatible with version 1.0.x.
|
As of version 1.2.0, you can omit many features that don't apply (e.g. like website), by not setting the values.
|
||||||
|
|
||||||
## Installation Instructions
|
## Installation Instructions
|
||||||
|
|
||||||
|
@ -34,12 +34,7 @@ dependencies {
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
## Example
|
## Setup AboutBox
|
||||||
### Setup Branch.io
|
|
||||||
|
|
||||||
Branch.io integration can be found [here](https://github.com/BranchMetrics/android-branch-deep-linking)
|
|
||||||
|
|
||||||
### Setup AboutBox
|
|
||||||
|
|
||||||
Add AboutBox configuration to your Application class
|
Add AboutBox configuration to your Application class
|
||||||
|
|
||||||
|
@ -90,23 +85,40 @@ Add AboutBox configuration to your Application class
|
||||||
aboutConfig.emailSubject = EMAIL_SUBJECT;
|
aboutConfig.emailSubject = EMAIL_SUBJECT;
|
||||||
aboutConfig.emailBody = EMAIL_BODY;
|
aboutConfig.emailBody = EMAIL_BODY;
|
||||||
|
|
||||||
// Branch.io labels.
|
|
||||||
aboutConfig.shareMessageTitle = getString(R.string.share_message_title);
|
|
||||||
aboutConfig.shareMessage = getString(R.string.share_message);
|
|
||||||
aboutConfig.sharingTitle = getString(R.string.sharing_title);
|
|
||||||
```
|
```
|
||||||
|
|
||||||
Open AboutBox screen
|
## Open the About Box from your app
|
||||||
|
|
||||||
```java
|
```java
|
||||||
AboutActivity.launch(activity);
|
AboutActivity.launch(activity);
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
## Sharing
|
||||||
|
|
||||||
|
By default, the default Android share intent will be called with the values specified in `shareMessage` and `sharingTitle`. For example:
|
||||||
|
```java
|
||||||
|
aboutConfig.shareMessage = getString(R.string.share_message);
|
||||||
|
aboutConfig.sharingTitle = getString(R.string.sharing_title);
|
||||||
|
```
|
||||||
|
|
||||||
|
Alternatively, you can provide a custom sharing function (and omit `shareMessage` and `sharingTitle`):
|
||||||
|
```java
|
||||||
|
aboutConfig.share = new IShare() {
|
||||||
|
@Override
|
||||||
|
public void share(Activity activity) {
|
||||||
|
// do custom sharing
|
||||||
|
}
|
||||||
|
};
|
||||||
|
```
|
||||||
|
|
||||||
## Theme
|
## Theme
|
||||||
|
|
||||||
Add to your AndroidManifest.xml file
|
If you add the following to your AndroidManifest.xml file, the About Box will use these colours. This allows you to match your app colours:
|
||||||
|
|
||||||
```
|
```xml
|
||||||
<activity
|
<activity
|
||||||
android:name="com.eggheadgames.aboutbox.activity.AboutActivity"
|
android:name="com.eggheadgames.aboutbox.activity.AboutActivity"
|
||||||
android:theme="@style/AppTheme.MaterialAboutActivity"/>
|
android:theme="@style/AppTheme.MaterialAboutActivity"/>
|
||||||
|
@ -120,7 +132,7 @@ Theme.Mal.Dark.LightActionBar
|
||||||
Theme.Mal.Dark.DarkActionBar
|
Theme.Mal.Dark.DarkActionBar
|
||||||
```
|
```
|
||||||
|
|
||||||
```
|
```xml
|
||||||
<style name="AppTheme.MaterialAboutActivity" parent="Theme.Mal.Light.DarkActionBar" >
|
<style name="AppTheme.MaterialAboutActivity" parent="Theme.Mal.Light.DarkActionBar" >
|
||||||
<!-- Customize your theme here. -->
|
<!-- Customize your theme here. -->
|
||||||
<item name="colorPrimary">@color/colorPrimary</item>
|
<item name="colorPrimary">@color/colorPrimary</item>
|
||||||
|
|
|
@ -12,7 +12,7 @@ android {
|
||||||
minSdkVersion 15
|
minSdkVersion 15
|
||||||
targetSdkVersion 24
|
targetSdkVersion 24
|
||||||
versionCode 4
|
versionCode 4
|
||||||
versionName "1.1.0"
|
versionName "1.2.0"
|
||||||
}
|
}
|
||||||
buildTypes {
|
buildTypes {
|
||||||
release {
|
release {
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue