User Guide

Download as pdf or txt
Download as pdf or txt
You are on page 1of 9

Android Web App Essentials

Getting Started
1. Choose your favorite version: Admob or Without AdMob
2. Import the project on Android Studio
3. Edit res -> values -> strings.xml
1. Change app_name
2. Change app_payoff
3. Choose the delay for splash screen on splash_delay
(milliseconds) ex. 1500 = 1,5 seconds
4. Insert your Analytics project id example: UA-XXXX-X for track
visitors.
4. Replace the icon app mipmap -> ic_launcher.png
5. Replace the small icon for menu mipmap -> icon.png
6. Replace your company logo mipmap -> your_logo.png
7. Choose your favorite colors theme values -> colors.xml

File: colors.xml
Uncomment your favorite version and comment the
first. If you want, you can change the HEX colors
with yours. See this page for understand colors
https://developer.android.com/training/material/theme.html

Setup your website


Edit res -> values -> strings.xml
For every page on menu, you can choose the type: file for local html file and url for remote
web pages.

Edit the menu label, the type and file name or url.
If you want use a local html, you can modify or insert your pages in assets directory.

If you want point to your website, you can change just the first block Home and put your web link.

Set up Google Maps


If you want use Google Maps on Contacts page, you must insert the coordinates with editing: res > values -> strings.xml fields to change: coordinate_lat and coordinate_long
To use Google Maps you must create project on you Google Api Console.
Go to this link: https://developers.google.com/maps/documentation/android-api/ and click GET A
KEY and follow the instructions.
When you finish, put your key on google_maps_key.

You dont want use a Google Maps on you Contacts Page?


Edit res -> layout -> fragment_contacts.xml and remove the fragment block.
Edit java -> FragmentContacts and delete this lines:

Set up GCM - Google Cloud Messaging


If you want the GCM for send push notifications to your customer, you must to follow this steps:
Like a google maps setup, you must to create or edit your project on Google Api Console.
Go to this link: https://developers.google.com/mobile/add and follow the instructions.
Android side
Edit res -> values -> strings.xml
Set your register.php url on the server_url value
Put your Project ID on: google_api_sender_id
Web Server side
1. Put the push_panel folder on your host server (with php support)
2. Create a database and import the .sql database
3. Edit register.php and sendpush.php, change the mysql connection with your access.
4. Configure your Api KEY (from Google Api Console -> Credentials) on sendpush.php.

How to change the left menu values


To Enable or Disable the left menu values you can edit this file:
res -> menu -> activity_main_drawer.xml
Comment the block like this:

Edit MainActivity.class and comment the line of the item:

Enable/Disable AdMob Banner (optional)


If you want to use Admob, you must create your account and your banner on admob website:
https://www.google.com/admob/
Create your banner and put the banner_id on strings.xml -> banner_ad_unit_id
example ca-app-pub-XXXXXXXX/XXXXXX
How to disable AdMob banner
If you want remove AdMob, follow these steps:
1. Edit res -> layout -> content_main.xml
2. Remove block com.google.android.gms.ads.AdView
3. Edit MainActivity and delete these lines:

Enable/Disable AdMob Interstitial (optional)


If you want to use Admob, you must create your account and your banner on admob website:
https://www.google.com/admob/
Create your Interstitial and put the instertitial_id on strings.xml -> interstitial_ad_unit_id
example ca-app-pub-XXXXXXXX/XXXXXX

How to disable AdMob Interstitial


If you want remove AdMob, follow these steps:
Edit MainActivity and delete these lines:

Set milliseconds delay for interstitial, change the above line on strings.xml
(10000 milliseconds = 10 seconds)

How to active RTL (Righit-to-Left)


Edit this file res -> values -> strings.xml and set true on string: rtl_version

How to translate in other languages?


If you want translate the app in other languages, you can insert the translation in strings file.
Edit values -> strings.xml - You can choose 5 different strings: Default (english), German, French,
Arabic, Spanish.
If you want you can add other language, you must to click + on the top bar.
Click the string that you want traslate above the language to translate it and write the translation.

How to disable navigation drawer? (left menu)


If you want disable the left menu (navigation drawer), you can follow this simple step:
Edit MainActivity.java and after toggle.syncState() put this lines:
toggle.setDrawerIndicatorEnabled(false);
drawer.setDrawerLockMode(DrawerLayout.LOCK_MODE_LOCKED_CLOSED);

and see the next step How to disable Floating Button

How to disable floating button?


Edit res -> layout -> app_bar_main.xml, select the Floating Button and set Gone on visibility
property.

How to fix the orientation screen?


If your prefer version is portrait, you can fix your app in portrait or in landscape mode:
Edit AndroidManifest.xml and add this line:
android:screenOrientation=portrait"
after every <activity open tag, like this:

How to disable Notification or General settings


If your prefer disable Settings Notification or General, you can follow this step:
Edit res -> xml -> pref_headers.xml and comment the block if you want disable, like this:

How to choose default loader and other default settings?


If you want, you can choose the default loader and default general settings by code.
For example, edit res -> xml -> pref_general.xml and change defaultVaue where you want.

For default loader, you can insert dialog, pull or none in defaultValue.

How to change title when change page?


You have 2 options: Fix title of all pages or dynamic title with label page.
If you want enable/disable this option, you can insert or comment next line a line in:
MainActivity -> onNavigationItemSelected (function)

If you remove or comment the function setTitle(item.getTitle()); the action bar title is every the
same (name of app).

How to change Share Text and Share link?


When you press the Share button, you can share the app link with mail, whatsapp, sms and
more
You can insert your text and the play store link of your app.
Edit strings.xml and Change the item: share_text and share_item
If you want disable Share button
You can edit MainActivity.java and comment this line:
inflater.inflate(R.menu.main, menu);

Preparing to publish on Play Store


Change the package name, because the name of package is unique on play store.
Right click on package and rename it:
After renaming, build your project and check all functions. If all is ok, generate Signed APK:
Click Build -> Generated Signed APK.
Create your Key, set your password and build it!
Upload the apk file in your Play Store Developer Account and good luck!

For any questions insert a comment


http://codecanyon.net/item/native-web-app-essentials/13183329
or send me a message.
Do you like my app?
Please make a little review!
@DigitalBorder 2015 - Follow me on twitter https://twitter.com/digitalborder15

You might also like