Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/SaadAhmed1122/Kids_learnig_App/llms.txt

Use this file to discover all available pages before exploring further.

This guide walks you through everything needed to get the Kids Learning App running locally — from cloning the repository to launching the splash screen on a physical device or emulator. The entire setup takes about five minutes if you already have Android Studio installed.

​
Prerequisites

Before you begin, make sure the following tools and environments are available on your machine:

Android Studio

Arctic Fox or later recommended. Download from developer.android.com/studio.

Android SDK

API level 19 (Android 4.4 KitKat) or higher must be installed via SDK Manager.

Java 8+

JDK 8 or later. Android Studio bundles a compatible JDK — no separate install needed.

Git

Required to clone the repository. Install from git-scm.com.
Google Play Services must be present on the target device or emulator for AdMob ads to initialise correctly. Standard Google Play emulator images include Play Services; AOSP images do not.

​
Setup Steps

1

Clone the Repository

Open a terminal and clone the project from GitHub:
git clone https://github.com/SaadAhmed1122/Kids_learnig_App.git
This creates a Kids_learnig_App/ directory containing the full Gradle project.
2

Open in Android Studio

Launch Android Studio, then navigate to File → Open and select the Kids_learnig_App/ folder you just cloned. Android Studio will detect the Gradle project automatically.
If Android Studio prompts you to upgrade the Gradle plugin, click Don’t remind me again for this project to keep the existing configuration and avoid unexpected build issues.
3

Sync Gradle Dependencies

After the project opens, Android Studio will begin a Gradle sync automatically. If it does not, click the Sync Project with Gradle Files button (elephant icon) in the toolbar.Gradle will download the following key dependencies:
DependencyVersion
androidx.appcompat:appcompat1.2.0
androidx.constraintlayout:constraintlayoutlatest
androidx.recyclerview:recyclerviewlatest
com.google.android.material:material1.2.1
com.google.android.gms:play-services-ads19.6.0
Wait for the BUILD SUCCESSFUL message in the Build output pane before proceeding.
4

Configure Your AdMob App ID

The app ships with a production AdMob App ID already declared in AndroidManifest.xml:
<meta-data
    android:name="com.google.android.gms.ads.APPLICATION_ID"
    android:value="ca-app-pub-7520984438935131~4453963759" />
For development and testing, replace the value with Google’s official test App ID to avoid invalid traffic:
<meta-data
    android:name="com.google.android.gms.ads.APPLICATION_ID"
    android:value="ca-app-pub-3940256099942544~3347511713" />
Running the production App ID on a development device can flag your account for invalid traffic. Always use the test App ID during development and restore the production ID only before a release build.
5

Run on a Device or Emulator

Connect an Android device via USB (with USB debugging enabled) or start an emulator with API 19 or higher from the AVD Manager.Click the Run button (▶) or press Shift + F10. Android Studio will build the APK and deploy it to the selected target. The app launches with SplashScreen and navigates automatically to Select_act, where children can choose between Learning and Games mode.

​
Orientation Note

Most screens in the Kids Learning App are configured for landscape orientation. When creating or selecting an emulator, choose a tablet-sized AVD (e.g., Nexus 7) or ensure your phone emulator supports landscape rotation. Physical devices will rotate automatically.
The Gallery (Show_ImagesMain) and Add Image (AddImge) activities use the device camera via an Intent. These features require a physical device or an emulator with a virtual camera configured in the AVD settings. On emulators without camera support, the camera Intent will fail silently — use a real device to test full gallery functionality.

Build docs developers (and LLMs) love

Get started for freeTalk to us