The visual component of a mobile application plays a decisive role in its success, and the first thing the user pays attention to is the icon. It is the face of your product on Google Play, on the main screen of your smartphone and in system menus. For developers, the question of how to change the application icon in Android Studio becomes one of the first questions when preparing a release, because a standard green robot is no longer suitable for presenting a commercial or unique project.
The modern Android ecosystem places strict demands on graphic resources, supporting both classic raster images and more flexible vector formats. The process of replacing the default icon has become much easier with the advent of a built-in tool Image Asset Studiothat automates the generation of resources for different screen densities. However, beginners are often faced with the nuances of setting up adaptive icons that appeared in Android 8.0 and confusion in project folder structures.
In this article we will analyze in detail the entire process from preparing the source image to the final APK assembly. You will learn how to use the import wizard correctly, what is the difference between foreground and background layers, and how to avoid common mistakes that can cause an icon to display incorrectly on devices from different manufacturers.
Preparation of the source image and format requirements
Before opening the development environment, you need to prepare a high-quality source file. Android Studio is capable of converting images, but the quality of the input data directly affects the result. The ideal option is to use vector graphics in SVG format, as they scale without loss of quality on screens of any resolution, from older models to modern flagships with 4K displays.
If you can't use vector, make sure that the bitmap image (PNG) has sufficient resolution. The minimum size should be 1024x1024 pixels, with the logo itself occupying the central part, leaving margins around the edges. This is necessary for correct cropping, as the system may cut off the edges when creating a responsive icon.
Use PNG-24 format with a transparent background for bitmap images to avoid white or black artifacts around the logo when overlaid on a colored background.
There is an important difference between the requirements for classic and responsive icons. Adaptive versions consist of two layers: foreground and background, which allows the system to dynamically change the shape of the icon depending on the theme of the user's device.
- 🎨 Use the SVG vector format for scalability and clarity at any DPI.
- 📐 Maintain a safe zone: important logo elements should be in the central 66% area.
- 🖼️ For raster images, choose a resolution of at least 1024x1024 pixels.
Do not forget that different smartphone manufacturers (Samsung, Xiaomi, OnePlus) may interpret shape masks differently. Therefore, your design should look good both in a circle and in a square with rounded corners.
Using Image Asset Studio to generate assets
The built-in asset creation wizard is the main tool that answers the question of how to change the application icon in Android Studio effectively and without manually editing XML files. To run it, right-click on the folder res in the project window, select Newand then Image Asset. A configuration dialog will open where you can manage all generation parameters.
At the top of the window you will see a resource type switch. The default is Launcher Icons (Adaptive and Legacy), which is the recommended setting for modern applications. This mode will automatically create the necessary files for both new versions of Android (API 26+) and older devices, ensuring compatibility.
The interface is divided into several tabs that allow you to customize every aspect of the display. The tab Foreground Layer is responsible for the main logo, and the Background Layer tab is responsible for the color or image of the background. The system will automatically show a preview of how the icon will look in various shapes (circle, square, rounded square), which allows you to immediately evaluate the result.
When working with the wizard, it is important to monitor the parameter Resize. If your logo is too big or small, the tool will prompt you to resize it automatically. However, it is better to do this carefully so as not to lose the details of small design elements.
Setting up responsive icons: Foreground and Background
Responsive icons, introduced in Android 8.0 (Oreo), represent a revolutionary approach to interface design. They consist of two separate layers: foreground (foreground) and background (background). The system applies a special mask (clip path) to them, which is set by the device manufacturer or the user in the theme settings.
In Image Asset Studio you can configure each layer independently. The foreground is usually the company or application logo itself. It is important that it does not touch the edges of the viewport, as the mask can cut off up to 34% of the image around the perimeter depending on the shape.
res/mipmap-anydpi-v26/
ic_launcher.xml (link to resources)
mipmap-hdpi/
ic_launcher_foreground.png
ic_launcher_background.png
The background layer can be a solid color, a gradient, or a complex pattern. If you choose a color, make sure it contrasts with the logo. Using an image in the background is allowed, but it should not distract attention from the main symbol of the application.
What will happen on older versions of Android?
On devices with Android versions lower than 8.0, the system will ignore the division into layers and use the generated legacy version of the icon, which is a single bitmap image that combines both layers.
Technically, the folder mipmap-anydpi-v26 creates XML files that reference resources in folders with specific pixel densities. This allows the system to dynamically load the necessary layers and apply masking to them on the fly, without requiring the developer to create dozens of options for each brand of smartphone.
Working with vector graphics and XML drawings
Using vector drawables (VectorDrawable) is a modern development practice for Android. Unlike raster images, vectors take up minimal space in the APK file and scale perfectly. In the wizard Image Asset Studio you can select the source type Clip Art or Imageby specifying the path to the SVG file.
When importing SVG, the system converts it to the internal Android format. Sometimes complex effects such as blurs or specific gradients may not be fully supported. In such cases, it is recommended to simplify the source file in a graphics editor before importing, or use a high-quality raster image as a compromise.
| Option | Vector (XML/SVG) | Raster (PNG) | Adaptive |
|---|---|---|---|
| File size | Minimum (KB) | Depends on resolution (MB) | Full |
| Scaling | Lossless | Pixelization when zoomed in | Depends on the source |
| Version support | Android 5.0+ | All versions | Android 8.0+ |
| Editable | High (code/colors) | Low (graphical editor required) | Layers shareable |
If you decide to use a vector for the background, you can set the color programmatically or via XML resources. This gives flexibility: for example, changing the background color of the icon depending on the installed dark or light system theme without rebuilding the application.
Vector graphics are preferable for icons, as they guarantee clarity on screens with high pixel density (xxhdpi, xxxhdpi) and save space in the application package.
For complex logos that are not possible vectorize correctly, PNG can be used in folders mipmap. In this case Android Studio automatically generates versions for different densities: mdpi, hdpi, xhdpi, xxhdpi and xxxhdpi.
Manual replacement of files and directory structure Mipmap
Although the automatic wizard is convenient, sometimes there is a need to manually replace files, for example, when updating branding without changing the project configuration. All icons are stored in directories res/mipmap-. It is important to understand the difference between folders drawable and mipmap: application icons should be stored in mipmap, since this folder is not compressed or deleted when the device configuration is changed.
The folder structure is as follows: mipmap-hdpi, mipmap-xhdpi and so on. If you are replacing files manually, make sure the file name matches the one in the manifest. Usually this is ic_launcher or ic_launcher_round.
⚠️ Attention: Never place application icons in the folder
drawable. The system may optimize this folder for a specific screen density, which may cause the icon to become blurry or disappear on other devices.
For adaptive icons in the folder mipmap-anydpi-v26 there are XML files that reference background and foreground resources. If you change the logo manually, you need to replace the files in the density folders (where the PNGs are located) and make sure that the links in the XML files for API 26+ remain valid.
☑️ Manual icon replacement
After replacing the files, be sure to run the command Clean Project i Rebuild Project in the Build menu. This will clear the build cache and ensure that new images are correctly packaged into the APK or AAB file.
Checking display and debugging in Android Manifest
The final step is to test how the system sees your new icon. All information about the application's graphic resources is stored in the file AndroidManifest.xml. Open it and find the tag <application>. The attribute android:icon points to the main icon, and android:roundIcon to the circular version for devices, where applicable.
<applicationandroid:icon="@mipmap/ic_launcher"
android:roundIcon="@mipmap/ic_launcher_round"
... >
If you created a responsive icon through the wizard, these attributes will refer to the resources in the folder mipmap-anydpi-v26. On older devices, the system will automatically pick up resources from folders with a specific density, ignoring the XML description of adaptability.
To quickly check the result without building a full release, use the function Preview in Android Studio or run the application on an emulator. Pay attention to how the icon looks in the list of running applications (Recents) and in the system settings.
⚠️ Attention: Manufacturer shell interfaces (MIUI, OneUI, ColorOS) can force their masks or filters to be applied to icons. What looks perfect on the Pixel Emulator may have a colored background on a Xiaomi smartphone.
It is also worth checking whether the icon is redefined in the configuration files for different build variants (flavors) if you are using production and test versions of the application. Sometimes build.gradle alternative resources for debug builds may be indicated.
Frequent errors and solutions to display problems
Despite the simplicity of the tool, developers often encounter the fact that the icon does not change after the build. The most common reason is resource caching by the Gradle build system or the emulator itself. In this case, a complete cache reset through the menu helps. File → Invalidate Caches / Restart.
Another problem is a size mismatch. If you manually inserted a small image into the folder for xxxhdpiit will look soapy. Always use a generator Image Asset Studiowhich will create the required sizes itself, or check the file resolution before replacing.
- 🔄 Clear the Gradle cache if the changes are not applied (.idea file and build folders).
- 📂 Check that the files are located in the mipmap folders and not drawable.
- 📱 Test on a real device, as emulators may render masks incorrectly.
If the icon appears as a white square, this usually means that the file is corrupted or the path to it in the manifest is incorrect. Check the Logcat logs when launching the application - there may be messages about an error loading resources.
When publishing to the Google Play Console, upload the icon separately in the store (512x512 PNG). The icon inside the APK is used only for installation on the device, and the file you downloaded is displayed in the store.
Remember that the process of changing the icon affects not only the code, but also the visual perception of the brand. Take time to test on different versions of Android to make sure the image is consistent.
Why does the icon not change after replacing a file in a folder?
Most likely, caching worked. Try running Build → Clean Project, then Build → Rebuild Project. If this does not help, remove the application from the emulator or device and install it again, since the system can cache the icon of the installed app separately from the code.
What is the difference between ic_launcher and ic_launcher_round?
ic_launcher is the main icon, which can be of any shape. ic_launcher_round is a special version for devices where the user has selected a round icon style in the system settings. Starting with Android 7.1, you can specify both options in the manifest.
Is it possible to make an icon completely transparent?
Technically, you can set a transparent background, but this is bad practice. On many devices, the background of the icons in the application menu has a certain color (white, black or theme color). The transparent icon will blend into the background or look like a hole. Always use an opaque background.
How to change the icon only for the debug version of the application?
Use Product Flavors in build.gradle. Create (flavor)"dev" and place alternative icons in the folder src/dev/res/mipmap. When building the dev version, these resources will be used, and for release - standard ones from main.
Are animated icons on the main screen supported?
The standard Android launcher does not support animated icons (GIF or AnimatedVectorDrawable) on the main screen. The icon will be static. Animation is only possible within the application or in some specific custom launchers, but not as a system standard.