Documentation

How to run this project

1. Unzip the downloaded code. After unzipping you will have World Flags - Android Code zip folder.
   Unzip World Flags - Android Code folder and open it in Android Studio or intellij
2. Open Android Studio and select as Open.
   
   
3. Select the Unzipped Folder and choose World Flags - Android Code Folder.

How to change package name

1. Change package name for android app
   Just navigate the gear icon at the top and click True Appearance -> Compact Middle Packages.
   
   
2. Right click th e package name you want to edit and click Refactor -> Rename.
   
   
3. Click In Whole Project.
   
   
4. Change the Package name and select All Places in the Scope.
   
   
5. Click Do Refactor at the Bottom Left of the screen.
   
   
6. Once you have changed the package name in the project files, Now you will do two more steps to change Package name of your android application.
   
   Select Build Gradle (App Module) in the Gradle Script.
   
   
7. Change the package name 'com.kulmis.worldflags' to your new package name.
   
   
8. One more time we have to modify our Manifests file.
   
   
9. And Change the package name 'com.kulmis.worldflags' to your new package name.
   
   

How to change Application name

1. Change application name for android app
   Just to res -> values -> string.xml and change the 'World Flags' to your new app name.
   
   

How to change Application Version

1. Change application version for android app
   Just navigate to Build Gradle (App Module) and change the versionName & versionCode to your new Version name & Version Code.
   
   

How to change Application Colors

1. Change application Colors for android app
   Just navigate to res -> values -> colors.xml and change the application colors.
   
   

How to change Application Icon

1. Change application Icon for android app
   Right click the App directory -> New -> Image Asset.
   
   
2. Change to your new App Launcher Icon and Click Next.
   
   
   

How to change Animation & Sound Files

1. Change application Animation & Sound Files for android app
   To change the Animation & Sound files navigate to res -> raw and change the application animation & sound files there.
   
   
   
Bonus: The Animations used in this app are available on LottieFiles Official website

How to Setup Application Admob Ads

1. Setup Application Ads using Admob
   Before we update our application's Admob field let us create Ad Units in Admob Dashboard
   
   Click 'ADD APP' in Admob Dashboard.
   
   
2. Choose 'Android' in the Platform, and 'No' in 'Is the app listed on a supported app store?'.
   
   
3. Add your App name.
   
   
4. You have succesfully Registerd you app on Admob.
   
   
5. Click 'ADD AD UNIT' to generate new Ad Units.
   
   
6. Choose Banner Ad for this Example, and click 'Select'.
   
   
7. Name your Banner Ad and click 'Create ad unit'.
   
   
8. Ad Unit Sucessfully created
   
   
9. Now Copy your App ID & Ad Unit ID and Past them in your project by navigating to
   res -> values -> string.xml
   
   


10. Note:
    Please don't use your Reals Ad Units if you are testing the app or using debbuging, insteade use the Dummy Ads which google supports, Read more on Admob Privacy & Policy Site

Setup Push Notifications

1. We will use Onesignal & Firebase to send push notifications diract to the Application.
   First we will setup our Firebase Account, so click this link to start.
   
   
   
   
   
   


2. Now let's go and setup a new Onesignal account.
   
   
   
   


3. Now let's go back to our Firebase Project and copy the Server key & the Sender ID.
   
   
   
   
   
   


4. Paste in Onesignal
   
   
   
   


5. Now Copy your Onesignal App ID and Paste into the Application
   java -> [package_name] -> helper -> Constant.java
   
   
   
   

How to Publish Your Application

1. Now it's the time to Publish the Application to the Play Store.
   So we need to Generate a Signed Bundle of the Application, To do that Navigate to the Top bar and click
   Build -> Generate a Signed Bundle / APK
   
   
   
   
   
   
   
   
2. Choose where to save your .jks file.
   I do save in my Android Project under [`KEY] Folder so as to not loss it!.
   
   
   
   
   
   
   
   
   
   
   
   

3. Congratulations.

   You have succesfully generated your signed application, and you are ready to publish in the Play Store.
   To Publish you app to the Play Store just visit the Official Android Page
   Or you can Google it Since it's commanly used.
   If you prefare a video tutorial we recommend you to watch This Video.

Important Changes

1. There are a few other things to consider.
   Navigate to helper -> Constant.java and update the boxed fields.
   
   
   



Note:
Please don't change the [DON'T CHANGE BELOW FIELDS] part, it my cause your app not to work probably.

FAQ

A FAQ is a list of frequently asked questions (FAQs) and answers on a particular topic.