The strings.xml
file
You can find this file into the
res/values
folder in Android Studio. Open this file and keep reading this guide, you'll have to perform some edits in this file in order to get your template ready to run:
App Name
Replace the following name with the new one you want to give to this app in this line:
<string> string name="app_name"> bCards </string>
AdMob Unit ID & App ID
Replace the values of these variables with your own
Interstitial Unit ID and
App ID strings.
name="ADMOB_INTERSTITIAL_UNIT_ID"> ca-app-pub-3940256099942544/1033173712< /string>
name="ADMOB_APP_ID">ca-app-pub-3940256099942544~3347511713< /string>
You have to create your
Unit ID at
apps.admob.com.
Follow the instructions on the AdMob's website in case you don't know how to generate an AdMob Unit ID.
The Configurations.java
file
Open this file from Android Studio and keep reading this guide, you'll have to perform some edits in this file in order to get your template ready to run:
Parse Server Keys
As explained in the
Quick Start section of this guide, you must replace the strings of the 2 variables below with your own
App Id and
Client Key that you will get from the back4app website after creating your own Parse App:
public static String PARSE_APP_ID = "K7SCPO9S6zywk3DMoEskABkJCOOWNkwx6Lfew2hy";
public static String PARSE_CLIENT_KEY = "kC36ZLG7UWs31cPpLUN3M8RkS6K6BK544MFYm3hD";
Custom colors
You can edit the
HEX values of the following variables as you wish. The main color of the app and some other Views will be affected by your change:
public static String MAIN_COLOR = "#48cfae";
public static String LIGHT_GREY = "#FFF8F8F8";
PLEASE NOTE that not all views will be affected by changing the HEX values above, you may still need to go through some XML file and adjust the colors on your own with the right-side Attributes panel.
Custom fonts
This App uses some custom fonts for Buttons, TextViews ans EditTexts. The font files are stored into the
app/src/main/assets/font
folder and are declared in this line:
public static Typeface osBold, osSemibold, osRegular, osExtraBold, osLight, osItalic;
Such fonts are initialized into the
onCreate()
function as follows:
osBold = Typeface.createFromAsset(getAssets(),"font/OpenSans-Bold.ttf");
osSemibold = Typeface.createFromAsset(getAssets(),"font/OpenSans-Semibold.ttf");
osRegular = Typeface.createFromAsset(getAssets(),"font/OpenSans-Regular.ttf");
osExtraBold = Typeface.createFromAsset(getAssets(),"font/OpenSans-ExtraBold.ttf");
osLight = Typeface.createFromAsset(getAssets(),"font/OpenSans-Light.ttf");
osItalic = Typeface.createFromAsset(getAssets(),"font/OpenSans-Italic.ttf");
In case you want to add a new font, you have to first drag your
.ttf
or
.otf
font file into the
app/src/main/assets/font
folder, then you have to instantiate it at the end of the
public static Typeface
line that's into the
onCreate()
function - let's pretend you have a font file called
Helvetica-Bold.ttf, you may add an instance called
hBold
(it's just an example, name it as you wish since it's a variable):
public static Typeface osBold, osSemibold, osRegular, osExtraBold, osLight, osItalic, hBold;
Lastly, import its path into the
onCreate()
function like the existing ones. Based on the font example above, your new line of code may look like this:
hBold = Typeface.createFromAsset(getAssets(),"font/helvetica-Bold.ttf");
Admin email address
You have to replace the email address of the variable below with your own one - the one you want users to use to get in touch with you:
public static String ADMIN_EMAIL_ADDRESS = "[email protected]"
Minimum distance from your Location
You can set the minimum distance form your location to search for business cards:
public static int DISTANCE_FROM_YOUR_
List of Categories
Check the following array:
public static String[] categoriesList = {
"Cleaning", // cat0
"Insurance", // cat1
"Finance", // cat2
"Real Estate", // cat3
"Events - Catering", // cat4
"Legal", // cat5
"Creative", // cat6
"Writing - Translating",// cat7
"Repairing Skills", // cat8
"Moving - Storage", // cat9
"Domestic Help", // cat10
"Beauty - Health", // cat11
"Computer Skills", // cat12
"Babisitter - Nanny", // cat13
// YOU CAN EDIT OR ADD CATEGORIES AS YOU WISH, JUST MAKE SURE TO ASSIGN THE PROPER IMAGES TO THE CATEGORIES
};
You can edit the names of the list as you wish, or add new ones. In case you'll add new Categories, you'll also have to add their images in the
drawable
folder in Android Studio - you can find it into the
res
folder.
Just keep in mind that the image names have a suffix number that indicates the index of the Category names in the above array, so, for instance, let's pretend you add an item like this below the
"Babisitter - Nanny", // cat13
item:
"Artistic stuff", // cat14
The
// cat14
comment is just to remind you that your image name must be
cat14.jpg
, so create a new .jpg image, name it
cat14.jpg
and drag it into the
drawable
folder - check the existing images to get the size of them.
That's it, run the app and check your brand new Category.
Parse Dashboard Classes and Utility functions
This section is a list of strings that the app calls to perform queries to the Parse Server database - aka Parse Dashboard - and it contains a few useful custom global variables and functions.
Do not edit those variables and instances unless you're an experienced Android developer, otherwise the app will not work properly.