magic-coder/materialabout

It's a material-design about screen to use on your Android apps. A developer profile and application information easy to integrate. 🔖

Material About

This is an Android project. You, as a mobile developer, can use this library to show a material about screen in your apps. It was build to make your life easier when introducing you to your users, and also, to create a about screen pattern for material android apps. It's really simple and dynamic, check it out.

##### Note: If you're missing some feature please let me know. Or even better, create a pull request. Also, I'm needing some help to translate the strings.xml to other languages.

Supported Languages until now: 🇺🇸 🇧🇷 🇪🇸 🇮🇹 🇷🇺 🇩🇪 🇨🇳 🇹🇷 🇺🇦

Sample app

This library has a lot more customization and features than is able to show here. Please check the sample app and feel free to help with a pull request. You can take a look at the sample app located on this project.

<img src="images/screenshots/custom.jpg" height='auto' width='280'/>

Setup

Step #1. Add the JitPack repository to your build file:

allprojects {
    repositories {
	...
	maven { url "https://jitpack.io" }
    }
}

Step #2. Add the dependency (See latest release).

dependencies {
       compile 'com.github.jrvansuita:MaterialAbout:+'
}

Implementation

Create a AboutView instance with AboutBuilder.

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    AboutView view = AboutBuilder.with(this)
                 .setPhoto(R.mipmap.profile_picture)
                 .setCover(R.mipmap.profile_cover)
                 .setName("Your Full Name")
                 .setSubTitle("Mobile Developer")
                 .setBrief("I'm warmed of mobile technologies. Ideas maker, curious and nature lover.")
                 .setAppIcon(R.mipmap.ic_launcher)
                 .setAppName(R.string.app_name)
                 .addGooglePlayStoreLink("8002078663318221363")
                 .addGitHubLink("user")
                 .addFacebookLink("user")
                 .addFiveStarsAction()
                 .setVersionNameAsAppSubTitle()
                 .addShareAction(R.string.app_name)
                 .setWrapScrollView(true)
                 .setLinksAnimated(true)
                 .setShowAsCard(true)
                 .build();

    addContentView(view, layoutParams);
}

Additional

Getting the list of actions or links from AboutBuilder.

    AboutBuilder aboutBuilder = AboutBuilder.with(this);

    List<Item> actions = aboutBuilder.getActions();
    List<Item> links = aboutBuilder.getActions();

Getting the view instance of any action or link from AboutView?

   AboutView view = AboutBuilder.with(this)
                    ...
                    .build();

   View lastLinkView = view.findItem(builder.getLastLink());
   View lastActionView = view.findItem(builder.getLastAction());