Documentation version 2.0
This documentation will help you familiarise yourself with the 'Estate' Android App and the web based Admin page. It is suggested that you first upload the admin page to your server and make sure it is working before continuing to the Android App. The Android App will work fine using the demo server, however it is required to setup firebase for it to work well without errors. The setup of Firebase is explained in the Admin Page Video Tutorial.
Username: admin Password: pass
Make sure your have Android Studio 2.2 installed and in the Android SDK Manager make sure you have the following installed:
Try to place the project file as close to root (C:/) as possible as windows has a path character limit of 240chars. So, if you get the error:"Failed to crunch file...", reduce the path length.
Step 1 - Open up Android Studio and click 'open an existing Android Studio project'.
Step 2 - Drag and drop the 'Estate' folder in the dialog to go quickly to the folder.
Step 3 - Make sure 'Estate' is highlighted and click 'ok'.
Step 4 - Go to your Firebase Console and download the 'google-services.json' file and replace the placeholder in app/google-services.json. This step is included in the Admin Page video - If you skip this step you will encounter an error during compile time.
Step 5 - Press the Play button to test the app on the emulator or connect your phone via usb to your computer to try it on your phone.
This step must be done else you will have problems uploading to Google play and the Rate feature will not work.
Step 1 - Make sure the 'Compact Empty Middle Packages' option is deselected as shown below.
Step 2 - Rename the package id by right clicking on 'neurondigital' and selecting 'refactor' and 'rename' as shown below.
Step 3 - Click Rename package.
Step 4 - In the popup menu type in your company name. Then press 'refactor' and in the next popup window press 'Do Refactor'. Do the same for 'estate'. The package name should be in this format: com.yourcompany.AppName
Step 5 - Open app/build.gradle and put in the same package id as before instead of the 'com.neurondigital.estate'. This is shown below.
Step 1 - Put in your Server url in Configurations.java
Step 2 - Replace the share deep link url in res/strings.xml. When the user opens a url that matches the url you specified here, it would be opened up in the estate app. If the app is not installed, the url would be opened on the browser, so make sure to choose a domain owned by you and has the server on it. eg: http://estate.neurondigital.com/1
The images can be found under app/res/drawable. To replace the images just copy/paste the image in the drawable folder to replace the other.
The icons can be found in app/res/mipmap. Notice that there are different sizes. To replace the icons just right-click->new->Image Asset and select your image.
Create an interstitial Ad on AdMob and paste the AD unit Id in the strings.xml file. The Ad displays when the user clicks a property in the home screen. Make sure to add this to start making money from your App. The display rate can be changed from strings.xml from the ad_shows_every_X_clicks parameter.
Like the interstitial Ad, create a Banner Ad on AdMob and paste the AD unit Id in the strings.xml file. The Ad displays in the bottom of the screen. Ideally to not annoy the user, it's either the banner or the interstitial ad, so you may wish to leave one of the Ad IDs in strings.xml empty.
Google Analytics where removed from the template in version 2 because it is now deprecated by Goolge. Use firebase analytics instead.
Go to the Google Maps API Key console, and use it to generate a Map API key. This is the same key used in the server. Put this in strings.xml in the 'GoogleMapKey' field.
To use this feature you need to purchase an 'Extended License' of the template from CodeCanyon. This feature is not covered in the 'Regular License.'
Step 1 - The template allows for the user to purchase a premium upgrade to remove ads using google Play In-app Payments. Before doing so, create your app in Google Play Dashboard and locate the 'Public Key' as it can seen below:
Step 2 - Then add a new in-app product and give it a Product id.
Step 3 - Finally, put your Public Key and product id in configuration.java:
All translatable text is contained within the strings.xml file.
Go to Build| Generate Signed APK... and export the .APK file.
Go to Configurations.java. Replace the LIST_1COLUMNS in the second line displayed below, with LIST_2COLUMNS if you wish to use grid view.
If you need any support,
----------------------------------------------------------------------------------------- Version 1 - Feb 2nd, 2017 ----------------------------------------------------------------------------------------- - Initial Upload ----------------------------------------------------------------------------------------- Version 2 - Jan 7th 2019 ----------------------------------------------------------------------------------------- - Bug Fix: sql database updated to be compatible with latest sql version - removed extra CALL_PHONE permission - Migrated to AndroidX - Updated to API 28 - removed Google Analytics. Use Firebase Analytics instead - Fixed issue in build.gradle related to the orger of jCenter() and google() - Now using the latest Admob Ads library with Admob app id. - Server Side: added submission date inputting - Server Side: added default gps coordinates in js/script.js - Server Side: Added support for php 7.2