Introduction

Please carefully read this guide in order to fully configure this template, and remember to test it on a Real Device – the Emulator may fail.

Quick Start

You may just run this app on your own device via Android Studio and play with it, it will work.
Anyway you need to customize this app into your own version, so just keep reading this guide.

General

Android Studio

This template has native Android Java/XML code so you can edit it only with Android Studio. If you don’t have it, download it for free.

Download Android Studio
PLEASE NOTE that you’ll need the latest official version of Android Studio, NO BETAS, because Betas are always buggy and never work properly.
Please make sure you have installed the following SDK Tools:

Change App Name

Enter the string.xml file – it’s into the res/values folder in Android Studio – and replace the App Name of this line with your new one: 
 <string> string name="app_name"> Opposite </string>

Change the Package Name

  • In the Project panel on the left side, click on the little gear icon.
  • Uncheck the Compact Empty Middle Packages option.
  • Your package directory will get separated into single directories, I'd suggest you to leave the com folder as it is and rename the other ones.
    So, for each directory you want to rename:
    • Right-click on it
    • Select Refactor -> Rename...
    • Click Rename Package in the popup
    • Enter a new name in the text field and click Refactor
    • Click Do Refractor in the Refactoring Preview tab on the bottom
    • Android Studio will update the changes, it may take a few seconds, just wait for the process to be done.


Next, open build.gradle (the Module app one) in Android Studio and rename the applicationId into your new package name, then click Sync Now on the top-right corner.

Reskin the UI design of the app

This project contains .xml files stored into the res/layout folder. Those files are the ones where you can edit all Views, Buttons texts, TextView’s strings, and all Views attributes – position, font color, size, etc.

Alert messages are located in the code, they can be edited only in the .java files.

All images are stored in the drawable folders, where the app icons are stored into the mipmap folders.

Configurations

• 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"> Opposite </string>

AdMob Ads

Replace the values of these variables with your own Interstitial Unit ID and App ID strings. 
 <string>name="ADMOB_INTERSTITIAL_UNIT_ID">ca-app-pub-3940256099942544/1033173712
 <string>name="ADMOB_APP_ID">ca-app-pub-3940256099942544~3347511713
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.

Custom Colors

You can edit the HEX values of the following variables as you wish the colors.xml file – you can find it into the res/values folder. The main color of the app and some other Views will be affected by your change: 
 <color name="top_color">#8FDAF4</color>
 <color name="bottom_color">#48CFAE</color>
 <color name="yellow_color">#F6D55C</color>
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 and EditTexts. The font files are stored into the app/src/main/assets/font folder and are declared in this line: 
 public static Typeface futuraBold;
These fonts are initialized into the onCreate() function as follows: 
 futuraBold = Typeface.createFromAsset(getAssets(),"font/Futura-Bold.otf");
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 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 popBold, popSemibold, ... 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");

List of English and Italian words with their hints

Check the following arrays: 
 public static String[] ENWords = {
            "'MOISTURE'-DRY-WET",
            "'TEMPERATURE'-HOT-COLD",
            "'STATES OF DAY'-DAY-NIGHT",
            "'DIRECTIONS'-ABOVE-BELOW",
            "'GOOD AND BAD'-ANGEL-DEVIL",
            "'AGES'-ADULT-CHILD",
            "'CONDITION OF LIFE'-ALIVE-DEAD",
            "'QUANTITY'-ALL-NONE",
            "'DAY AND NIGHT'-SUN-MOON",
            "'THINGS HAPPEN'-ALWAYS-NEVER",
            "'COLORS'-BLACK-WHITE",
            "'SEASONS'-WINTER-SUMMER",
            "'DIRECTIONS'-FRONT-BACK",
            "'SOON OR LATER'-BEFORE-AFTER",
            "'BETTER OR NOT'-BEST-WORST",
            "'SIZE'-BIG-SMALL",
            "'CUTTING'-SHARP-BLUNT",
            "'STUFF CONDITION'-OLD-NEW",


            // YOU CAN ADD WORDS HERE (THE NUMBER OF ITEMS OF THIS ARRAY MUST BE EQUAL TO THE OTHER ONES - PLEASE REFER TO THE DOCUMENTATION)
    };


    public static String[]  ITWords = {
            "'TEMPERATURA'-FREDDO-CALDO",
            "'STATI DELLA GIORNATA'-GIORNO-NOTTE",
            "'GIORNO E NOTTE'-SOLE-LUNA",
            "'DIREZIONI'-SOPRA-SOTTO",
            "'GENITORI' '-PADRE-MADRE",
            "'PARTI DEL MONDO'-TERRA-CIELO",
            "'VIVERE E...'-VIVO-MORTO",
            "'QUANTITA' '-TUTTO-NIENTE",
            "'COLORI'-BIANCO-NERO",
            "'LE COSE ACCADONO'-SEMPRE-MAI",
            "'CONDIZIONE DI UN OGGETTO'-VECCHIO-NUOVO",
            "'DIREZIONI'-FRONTE-RETRO",
            "'ARRIVARE IN TEMPO'-PRIMA-DOPO",
            "'ALFA E OMEGA'-INIZIO-FINE",
            "'PUO' DIVENTARE SOLIDO'-ACQUA-GHIACCIO",
            "'ASPETTO FISICO'-BELLO-BRUTTO",
            "'ESSERE UMANO'-ANIMA-CORPO",
            "'CUTTING'-SHARP-BLUNT",

            // YOU CAN ADD WORDS HERE (THE NUMBER OF ITEMS OF THIS ARRAY MUST BE EQUAL TO THE OTHER ONES - PLEASE REFER TO THE DOCUMENTATION)
    };
You may notice that each of the above arrays names is made by the first 2 language code digits (EN for English, IT for Italian).
If you want to add a new array of words, let’s says a German array, follow these steps:
  • Copy the whole ENWords array
  • Paste it below the ITWords array
  • Rename your new array into GEWords and edit all its items into the words and hints you want for the German language

After you’ve added your new array of words and hints, you may need to add your language’s alphabet list, like the English and Italian ones of these variables: 
 public static String[] ENAlphabet = {"A","B","C","D","E","F","G","H","I","J","K","L","M","N","O","P","Q","R","S","T","U","V","W","X","Y","Z"};
public static String[] ITAlphabet = {"A","B","C","D","E","F","G","H","I","L","M","N","O","P","Q","R","S","T","U","V","Z"};
In this case, copy the ENAlphabet array and paste it below the ITAlphabet one, name it GEAlphabet and set all the characters of the alphabet of that language. here’s an example of how it should look: 
 public static String[] GEAlphabet = { "A","B","C", etc... };
Then you need to add your new language name into the following array: 
 public static String[] languagesArray = {
            "English",
            "Italiano",
};
So add “German”, right below “Italiano”.

You have also to add all translated strings into the void setTextsIntoSelectedlanguage(String language) function.
Take the existing switch cases as an example, copy the code from case "English": to break; and paste it below the following comment: 
 // YOU CAN ADD TRANSLATIONS HERE - PLEASE REFER TO THE DOCUMENTATION
One last thing to do is to enter GameScreen.java and check the following code in the loadWords() function: 
 // Set the array of words based on the selected language
switch (selectedLanguage){
    case "English": alphabet = ENAlphabet;   wordsArr = ENWords[lastLevel].split("-"); break;
    case "Italiano": alphabet = ITAlphabet;   wordsArr = ITWords[lastLevel].split("-"); break;

    // YOU CAN ADD YOU CASES HERE IN CASE YO HAVE ADDED SOME MORE LANGUAGE (PLEASE REFER TO THE DOCUMENTATION)

    default: break;
}
Below that comment, you must add a line like this (still considering the German language as an example): 
 case "German": alphabet = GEAlphabet;   wordsArr = GEWords[lastLevel].split("-"); break;
PLEASE NOTE: Each item of the arrays is made by 3 words:
  • The 1st one is between ' ' because it’s a hint, and it’ll be shown on the top of the screen, below the LEVEL number.
  • The 2nd and 3rd words are the words that players have to guess, one is the opposite meaning of the other.
  • If you want to add new items to the arrays, just keep their formatting style, which separates hint and words by the - symbol.

Example: let’s pretend you want to add COLD and HOT in the ENwords array, you have to think about a hint and add a line like this: 
"'TEMPERATURE'-HOT-COLD",
PLEASE NOTE that the number of items of an array, either the ENWords or the ITwords one (or even a new array of words you may add), must be the same, which means that if the ENWords array has 20 items – for instance – all the other arrays must have 20 items as well!
IMPORTANT: The maximum number of characters allowed for each of the 2 words to guess is 6, so do not insert words that are longer than 6 characters otherwise the app will crash.
Instead, for the hint string, you can type anything, anyway just make it short an clear, it must be a simple hint to help player to guess the 2 words 🙂

Sound clips

There’s a folder in Android Studio called raw – it’s inside the res folder – which contains a few audio files, you may replace those sound clips with other files, just don’t rename them, name your new sound files like the existing ones and replace the existing ones with your new ones, so you won’t have to edit a single line of code.

Utility Functions

Unless you are familiar with Android programming, you should leave the code of this section as it is since it includes useful functions to show alerts and perform other things in the app.

F.A.Q.

If I buy this app template, can I use for multiple projects?

No, only 1 app/purchase.
In case you want to publish more than 1 application using this template, you must purchase a License for each project you want to publish on the App/Play Store, either the Regular ot the Extended one

What kind of support is offered?

Free support is offered in case of bugs encountered in the original template, either in the code or the UI design.
In case you have edited the code – and so created bugs because of your editing – I may apply some fee to fix your bugs by a remote connection through AnyDesk, or by you sending me your source code for verification.

Should I use Android Studio to edit this template?

Yes, you must always use the latest stable official version of Android Studio to edit this application – NO Betas, they don’t work properly!
Download Android Studio

I’ve performed all configurations mentioned in this Guide, but something is wrong. What should I do?

  • Double-check all your configurations, probably you have missed something
  • Always check the Logcat in Android Studio if the app crashes, usually the error messages are shown in red color
The Logcat helps you to debug your app, it’s really important!

How do I remove AdMob ads?

It’s super easy, just open the Find in Path tool in Android Studio by clicking Edit -> Find -> Find in Path, and search for: 
 showAdMobInterstitial
The Find in Path window will show you a list of files where that string is located.
Just comment out (or delete) the following line of code in each file and the app will not show AdMob ads on next run: 
showAdMobInterstitial(ctx);

Support

PLEASE NOTE: I can offer FREE support for bugs/errors encontered in the original code.

Email me through my Profile's Contact Form on Envato