Android App Setup Documentation

This guide explains how to set up the Android application for DevBase from scratch — including project import, package name change, API configuration, Firebase setup, and push notifications.

🎥 Android Setup Video

Recommended: Watch once completely before starting setup.

1. Extract & Open Project

  • Extract the downloaded Android ZIP file
  • Open Android Studio
  • Select Open an Existing Project
  • Choose the extracted project folder

2. Change Package Name

Update package name from Android Studio:

  • Right click package → Refactor → Rename
  • Select Rename Package
  • Update everywhere

Also update in app/build.gradle:

applicationId "com.yourcompany.appname"

3. Update Java / Kotlin Config File

Open the main config file (usually inside utils or config package):

  • Confirm updated package declaration
  • Check base constants

4. API Base URL Configuration

Edit API client file (example: APIClient.java):

public static final String BASE_URL = "https://yourdomain.com/api/";
Make sure BASE_URL points to live Laravel backend.

5. App Name & Logo

  • Update app name in res/values/strings.xml
  • Replace launcher icons in mipmap folders
  • Ensure all sizes are replaced

6. Firebase Project Setup

  • Create project on Firebase Console
  • Add Android app
  • Enter the same package name
  • Download google-services.json
  • Place it inside app/ directory

7. Enable Authentication & Notifications

  • Enable Google Sign-In in Firebase Authentication
  • Enable Cloud Messaging
  • Copy FCM Server Key

8. Laravel Admin – FCM Configuration

Add Firebase JSON or server key in Laravel admin panel:

  • Upload Firebase JSON (if required)
  • Save FCM server key
  • Enable push notification toggle
This allows sending push notifications to Android users.

9. Test & Generate Build

  • Sync Gradle
  • Run app on real device
  • Test login, APIs, notifications
  • Generate signed APK / AAB
✅ Android setup completed successfully. If notifications or login fail, re-check Firebase package name and keys.