MoneyMeter Android App Documentation

Step 1: Install Latest Android Studio

Download and install the latest version of Android Studio from the official website.

Step 2: Launch Android Studio

Open Android Studio and wait for it to load completely.

Step 3: Open Our Project

Follow these exact steps:

1. Click "Open" from the welcome screen (or File > Open if already in a project)
2. Navigate to the folder where you extracted MoneyMeter
3. Select the root project folder (contains gradle files)
4. Click "OK"

Select the root project folder that contains build.gradle

Step 4: Let Android Studio Build

After opening:

• Android Studio will automatically begin syncing and building
• Wait for the process to complete (check progress bar at bottom)
• If prompted, accept any license agreements

Step 5: Verify Successful Build

Check for:

• No red error messages in the "Build" tab
• "Gradle sync finished" notification
• All files visible in the Project view

Step 1: Open strings.xml

Navigate to res > values > strings.xml in the project explorer.

Step 2: Modify app_name

Find the following line and change the value to your desired app name:

<string name="app_name">MoneyMeter</string>

Step 3: Rebuild the App

After making changes, rebuild the app to see your new app name.

Step 1: Enable Compact Empty Middle Packages

In Android Studio's project view, click the gear icon and check "Compact Empty Middle Packages" to see the full package structure.

Enable "Compact Empty Middle Packages"

Step 2: Refactor Package Name

Right-click on the package name (com.example.moneymeter) and select Refactor > Rename. Enter your new package name (e.g., com.yourcompany.yourapp).

Step 3: Update build.gradle

Open build.gradle (Module: app) and update the applicationId to match your new package name:

android {
    defaultConfig {
        applicationId "com.yourcompany.yourapp"
        // ... other configurations
    }
}

Step 4: Update AndroidManifest.xml

Open AndroidManifest.xml and ensure the package attribute matches your new package name:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.yourcompany.yourapp">

Step 1: Open colors.xml

Navigate to res > values > colors.xml to modify the primary color scheme.

Step 2: Modify Color Values

Change the HEX color values to your preferred colors:

<color name="colorPrimary">#4A6BFF</color>
<color name="colorPrimaryDark">#3A56CC</color>
<color name="colorAccent">#FF6B6B</color>

Step 3: Update Theme

For more advanced theme changes, edit res > values > styles.xml to modify the app's overall theme.

Step 1: Delete Old Icons (Clean Start)

First remove all existing icon folders to prevent conflicts:

1. In Android Studio, expand the res folder
2. Right-click each mipmap-* folder and select Delete:

   mipmap-anydpi-v26
             mipmap-hdpi
             mipmap-mdpi
             mipmap-xhdpi
             mipmap-xxhdpi
             mipmap-xxxhdpi

3. Confirm deletion when prompted

Step 2: Prepare Your Logo

Have your logo image ready (PNG format recommended):

• Minimum 512×512 pixels for best quality
• Transparent background if needed
• Simple, recognizable design

Step 3: Generate New Icons

Use Image Asset Studio to create all icon versions:

1. Right-click the res folder
2. Select New > Image Asset
3. In the dialog:
   • Set Icon Type to "Launcher Icons"
   • Click Path to select your image
   • Choose background shape (circle, square, etc.)
   • Adjust padding if needed
4. Click Next > Finish

Image Asset Studio will recreate all necessary mipmap folders

Step 4: Verify Generated Folders

Check the res directory now contains:

res/
            ├── mipmap-anydpi-v26/ (adaptive icons)
            ├── mipmap-hdpi/
            ├── mipmap-mdpi/
            ├── mipmap-xhdpi/
            ├── mipmap-xxhdpi/
            └── mipmap-xxxhdpi/

Step 5: Clean and Rebuild

From the Android Studio menu:

1. Select Build > Clean Project
2. Then Build > Rebuild Project
3. Run the app to see your new icon

Step 1: Create AdMob Account

If you don't have one, create an account at admob.google.com.

Step 2: Add Your App

In your AdMob dashboard, click "Add App" and select "Android". Enter your app's details.

Step 3: Create Ad Units

Create ad units for each ad type (Interstitial, Rewarded, App Open) in your AdMob dashboard.

Step 1: Open strings.xml

Navigate to res > values > strings.xml in the project explorer.

Step 2: Replace Ad IDs

Find the following AdMob configuration and replace the values with your own AdMob IDs:

<string name="admob_interstitial_ads_id">ca-app-pub-3940256099942544/1033173712</string>
                    <string name="admob_rewards_ads_id">ca-app-pub-3940256099942544/5224354917</string>
                    <string name="admob_app_open_ads_id">ca-app-pub-3940256099942544/3419835294</string>
                    <string name="admob_app_id">ca-app-pub-3940256099942544~3347511713</string>

Replace AdMob IDs in strings.xml

Step 3: Test Ads

Use test ad IDs during development to avoid invalid clicks:

<string name="admob_interstitial_ads_id">ca-app-pub-3940256099942544/1033173712</string>
<string name="admob_rewards_ads_id">ca-app-pub-3940256099942544/5224354917</string>
<string name="admob_app_open_ads_id">ca-app-pub-3940256099942544/3419835294</string>
<string name="admob_app_id">ca-app-pub-3940256099942544~3347511713</string>

Step 1: Generate Signed Bundle/APK

In Android Studio, select Build > Generate Signed Bundle / APK.

Step 2: Create Keystore

If you don't have a keystore, create one. This is required for publishing updates to your app.

Step 3: Build Release APK

Follow the wizard to build either an Android App Bundle (recommended) or APK.

Step 1: Test on Multiple Devices

Test on different screen sizes and Android versions if possible.

Step 2: Verify All Features

Check that all features work correctly after your customizations.

Step 3: Test Ad Integration

Verify that ads are displaying properly with your new AdMob IDs.