Android Configuration

Estimated reading: 3 minutes

Setting up Android for your KiviCare - Laravel Project

Open Android Module

• The Android module can be accessed in Two ways:

1. Select the Android Module from the same project you're attempting to open by going to File -> Open.

   

2. Navigate to Tools -> Flutter -> Android Studio -> Open Android Module.

   

Change The Application Id

IMPORTANT

Every Android app has a unique application ID that looks like a Java package name, such as com.example.myapp. This ID uniquely identifies your app on the

device and in the Google Play Store. Once you publish your app, you should never change the Application ID.

• For Application ID, change the applicationId in the app/build.gradle file.
• Locate the build.gradle file at this path: android/app/build.gradle.

defaultConfig {
    applicationId "YOUR_PACKAGE_NAME"
    minSdkVersion 21
    targetSdkVersion 31
    versionCode 1
    versionName "1.0"
    testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
}

Change The Version Name

IMPORTANT

The version name is a string value that represents the "friendly" version name displayed to the users. The version name is displayed to the user.

• For Version Name, change the versionName in the build.gradle file at the app level.
• Locate the build.gradle file at this path: android/app/build.gradle.

defaultConfig {
    applicationId "com.iqonic.example"
    minSdkVersion 21
    targetSdkVersion 31
    versionCode 1
    versionName "CHANGE_THE_VERSION_NAME"
    testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
}

Change The Version Code

IMPORTANT

The version code is an incremental integer value that represents the version of the application code. The version code is used by the Google Play Store for new updates. If you increase the version code, the update will be visible to all users.

• For Version Code, change the versionCode in the build.gradle file at the app level.
• Locate the build.gradle file at this path: android/app/build.gradle.

defaultConfig {
    applicationId "com.iqonic.example"
    minSdkVersion 21
    targetSdkVersion 31
    versionCode "CHANGE_THE_VERSION_CODE"
    versionName "1.0.0"
    testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
}

Change The App Name From Manifest File

IMPORTANT

To change the name of your Android application in Android Studio, you have to change the value of the property android:label defined inside the <application> node in AndroidManifest.xml.

<application
    android:label="YOUR_APP_NAME">
</application>

Generate App Launcher Icon

IMPORTANT

Android Studio includes a tool called Image Asset Studio that helps you generate your own app icons from material icons, custom images, and text strings. It generates a set of icons at the appropriate resolution for each pixel density that your app supports. Image Asset Studio places the newly generated icons in density-specific folders under the res/ directory in your project. At runtime, Android uses the appropriate resource based on the screen density of the device your app is running on.

Image Asset Studio helps you generate the following icon types:

• Launcher icons Adaptive & Legacy
• Legacy Launcher Icon
• Action bar and Tab Icons
• Notification icons
• Tv Banner
• Tv Channel Icon

For More Details You can checkout Android Studio Editor Guide for creating Android Icons.

Generate Icon Process

• Configure Image Asset

  • Choose Icon type
  • Set Icon Name
  • Choose Asset Type
  • Customize Icon (Resize , Trim , Padding)

• Confirm Icon Path

  • Choose Mode for Icon
  • Finish

Generate App Launcher Icon

Method 1 : Use Android Studio To Generate Launcher Icons

• Go to android/app/src/main/res folder.

• Right-click on the res folder and select New → Image Asset.

  

info

Foreground Layer : The foreground layer is the primary part of the icon that contains the main visual elements. It's the layer that the user selects the source asset for, which can be an image, clip art or text.

Background Layer : The background layer is the area behind the foreground layer. It can be used to add a background color or image element to the icon. If you don't want green background for laucher Icon then set background layer suitable to your Launcher Icon.

• Choose Icon Type - "Launcher icons Adaptive & Legacy"

• Select the path of your Image and press Next.

• Select App mode for app Icon.

• Then Press Finish.

  

Method 2 : Generate Online

• Icon Kitchen
• App Icon Generate

The basic process of this website is -

• Choose Asset type
• Basic Configuration
• Choose Device Type
• Generate and Get the Zip
• After extracting zip you get res folder replace it with your android/app/src/main – res folder

Generate Notification Icon

• Go to android/app/src/main/res folder.

• Right-click on the res folder and select New → Image Asset.

• Choose Icon Type - "Notification"

• Select the path of your Image and press Next.

• Select App mode for app Icon.

• Then Press Finish.

  

Change notification icon in Androidmanifest.xml

• Navigate to android/app/src/main.

• Open your Androidmanifest.xml and check for lines below. If not exist just add this line otherwise Paste the Name of Icon you just created into “android:resource“.

<meta-data
    android:name="com.google.firebase.messaging.default_notification_icon"
    android:resource="@drawable/ic_stat_notification" />

info

Update notification icon name into "lib → utils → push_notification_service.dart" Follow the Steps mentioned in Flutter Configuration

Add Google JSON File

info

As part of enabling Google APIs or Firebase services in your Android application, you need to set up Firebase and download the Google JSON file.

Click Here to set up Firebase and download the Google JSON file.

Generate Signed APK

To generate a signed APK (Android Package), follow these steps:

1. Open the build menu and Select Generate Signed Bundle/APK.Choose APK and click Next.

   

   

2. Now you will have two options create a new Keystore or choose existing keystore.

   • If you choose to create a new keystore:
   • A dialogue will appear, prompting you to specify the path of the keystore and give it a name.
   • Enter your password and confirm it.
   • Select the alias name.
   • Confirm the password.
   • Enter any additional information if required.
   • Click OK to create your keystore.

• If you choose to use an existing keystore, simply select it.

  

  After selecting your keystore or creating a new one, click Next.

  

Choose the release mode and proceed with building the APK.

NOTE:

If you intend to publish your app on the Google Play Store, you will need the AAB (Android App Bundle) format. To create an AAB, follow the same steps mentioned above, but in step 2, select the AAB option instead of APK.

Successful !!

Great! You have successfully configured the Android module!