An OpenSource WallPaper App with awesome UI/UX Desingn with Unsplash api.

Documentation of Mobile Wallpaper application

Hi Please follow below steps to configure and make changes in application source code.

Try apk

Download apk here

Installation

Before you start

Current documentation was created to help you with quick installation and configuration of Mobile-wallpaper-app.

Please, read it carefully to avoid most of potential problems with incorrect configuration.

Below chapter describes how to install Android SDK and Android Studio. You don’t have to install Android Studio, but it’s better. The project can be built without Android Studio, using Gradle and Android SDK. Gradle is a build system used for building final APK file.

Once you will have activated the theme you will need to change some of the pages and settings for optimal performance. That’s why, please, do not contact the Support center beforehand. Read firstly the documentation, implement all the steps following the instructions and only after that, if the issues persist, contact us.

Download and Install Java

If you have downloaded and instal led Java JDK then move to next point.

Download & Install Java from here

Download Java by clicking on Java Platform (JDK)

Install Android Studio

Download & Install Android Studio from here Download Android Studio

Run Android SDK Manager and download necessary SDK packages, make sure that you have installed Android SDK Tools, Android SDK Platform-tools, Android SDK Build-tools, Android Support Repository, Android Support Library and Google Play services.

Now you should be able to open/edit the Android project and build APK.

How to create Unsplash account

Go to https://unsplash.com/ link create your account you can see your home page.

Then go to Api/Developers

Enter image description here

You can see below page Click on Your Apps button then you can display the below page.

Click on New Application then display the below page. check all checkbox then you can visible Accept Terms button click on Accept Terms button you can display below dialog.

Enter your Application name and also add Description then you can access your Access Key and Secret key.

Use Access Key in Application.

How to Import Project

To Import project you need to start android studio which you already downloaded, Once android studio start follows below steps to import the project in the android studio.

Follow steps to import project

First of all go to the location where you have placed this app source code

1.Please extract the zip file in the same location

2.Now select “Import Project (Gradle, Eclipse ADT, etc.)” from Android Studio.

3.Browse location where you have placed NearBy Code and press “OK” button.

4.Now, wait till android studio complete the Importing project successfully. 1

Import project

By clicking on import project you will get file browser dialog, select your code location and press OK button.

Customize Project

Project Structure

After importing project successfully you will get project structure like below image

Project Structure

Within each Android app module, files are shown in the following groups:

manifest

Contains the AndroidManifest.xml file.

java

Contains the Java source code files, separated by package names, including JUnit test code.

res

Contains all non-code resources, such as XML layouts, UI strings, and bitmap images, divided into corresponding sub-directories. For more information about all possible resource types, see Providing Resources.

To know more about project structure please go through this link Android Project Structure

Change App icon

Place your app icon inside mipmap folder -> app\src\main\res\mipmap\

Icon name should be “ic_launcher.png”

Change application package name

In Android Studio, you can do this:

For example, if you want to change com.example.app to my.awesome.game, then:

1. In your Project pane, click on the little gear icon ( )

2. Uncheck / De-select the Compact Empty Middle Packages option

3. Your package directory will now be broken up in individual directories

4. Individually select each directory you want to rename, and:

   • Right-click it
   • Select Refactor
   • Click on Rename
   • In the Pop-up dialog, click on Rename Package instead of Rename Directory
   • Enter the new name and hit Refactor
   • Click Do Refactor in the bottom
   • Allow a minute to let Android Studio update all changes
   • Note: When renaming com in Android Studio, it might give a warning. In such case, selectRename All

   

5. Now open your Gradle Build File (build.gradle - Usually app or mobile). Update the applicationId in the defaultConfig to your new Package Name and Sync Gradle, if it hasn’t already been updated automatically:

   

6. You may need to change the package= attribute in your manifest.

7. Clean and Rebuild.

8. Done! Anyway, Android Studio needs to make this process a little simpler.

Change Application Name

Go to App -> res -> value -> String.xml -> Change in below line

Change Accesskey In Application

Go to App -> Java -> wallsplash -> ankit -> com -> retrofit -> config.java -> replace your Accesskey in below line

Change Firebase Database Name

Go to App -> Java -> wallsplash -> ankit -> com -> retrofit -> config.java -> replace your firebase database link in below line

Admob Configuration

How to Integrate Google AdMob in your App

Introduction

AdMob is a multi platform mobile ad network that allows you to monetize your android app. By integrating AdMob you can start earning right away. It is very useful particularly when you are publishing a free app and want to earn some money from it.

Integrating AdMob is such an easy task that it takes no more than 5mins. In this article, we’ll build a simple app with two screens to show the different types of ads that AdMob supports.

Creating Ad Units

NOTE: AdMob admin interface changes quite often. The below steps to create Ad Unit IDs might differ from time to time.

Want to know more?? Follow this link - https://developers.google.com/admob/android/quick-start​

1. Sign into your AdMob account.

2. Create a new App by giving the package name of the app you want to integrate AdMob. Once the App is created, you can find the APP ID on the dashboard which looks like ca-app-pub-XXXXXXXXX~XXXXXXXXX.

3. Select the newly created App and click on ADD AD UNIT button to create a new ad unit.

4. Select the ad format and give the ad unit a name.

5. Once the ad unit is created, you can notice the Ad unit ID on the dashboard. An example of ad unit id look like ca-app-pub-066XXXXXXX/XXXXXXXXXXX

Create ad unit for banner ads

After creating banner ad unit and interstitial ad unit you have to place you adUnit id in string.xml file.

app > res > values > string.xml {#app--res--values--string.xml}

OneSignal integration

OneSignal is a high volume and reliable push notification service for websites and mobile applications. To know more about onesignal follow this link - https://onesignal.com/

---

Follow this link to configure onesignal in your app https://documentation.onesignal.com/docs/android-sdk-setup​

Place your OneSignal App ID in build.gradle(Module:app) file in the project

manifestPlaceholders = [  
    onesignal_app_id : 'PLACE YOUR ONESIGNAL APP ID HERE',  
    // Project number pulled from dashboard, local value is ignored.
    onesignal_google_project_number: 'REMOTE'  

]

Replace your generated google-service.json inside App Directory in project

Firebase Database Setup

Please refere below link for create new app in firebase.\

http://mariechatfield.com/tutorials/firebase/step1.html

Firebase Email Auth Setup

Please refere below link for enable Email auth in firebase.

https://firebase.google.com/docs/auth/web/email-link-auth

Facebook Login for Android - Quickstart

The Facebook SDK for Android enables people to sign into your app with Facebook Login. When people log into your app with Facebook they can grant permissions to your app so you can retrieve information or perform actions on Facebook on their behalf.

Please follow below link and perform action as per described\

(https://firebase.google.com/docs/auth/android/facebook-login#next_steps)

Place your facebook app id inside string file in your code

<string name="facebook_app_id" translatable="false">PLACE YOUR FACEBOOK APP ID HERE</string>
<string name="fb_login_protocol_scheme" translatable="false">fb[PLACE YOUR FACEBOOK APP ID HERE]</string>  

Resource Credits

Thanks for provide great material and I am very appreciates to our assets provider.

---

Images sources (CC0)
Pexels.com
[Unsplash.com

PushNotification
https://onesignal.com/