Developing a mobile application is not only about writing code and debugging logic, but also about creating an attractive visual image. The first thing a user encounters in the Google Play store or on the screen of his smartphone is the graphic symbol of the app. That is why the question of how to change the application icon in Android Studio is one of the most common among beginners and experienced developers. An incorrectly chosen image can reduce the number of installs, while a high-quality design increases the trust of the audience.
Modern Google standards require compliance with strict design rules, including support for adaptive icons for different versions of the operating system. In the Android Studio development environment, this process is greatly simplified thanks to the built-in tool Image Asset Studio. You no longer have to manually convert images to different resolutions or create separate folders for each screen density. The tool automatically generates the necessary resources, saving time and minimizing the risk of errors when manually setting up files.
In this article we will analyze in detail the entire process of replacing a standard green robot with your unique logo. We'll look at preparing source files, working with the import wizard, setting up layers for adaptive icons, and checking the result on the emulator. We will also pay attention to common problems that developers encounter and give tips on optimizing graphics for better viewing on various devices.
Preparing the source image and requirements
Before opening the project in the IDE, you must properly prepare the source logo file. The quality of the final result directly depends on the quality of the source. It is recommended to use a vector format SVG or a high-resolution raster image in PNGformat. Vector graphics are preferable because they scale without losing quality, which is critical for generating icons for screens with different pixel densities.
If you are working with raster graphics, make sure that the source image is square and has sufficient resolution. The minimum recommended size is 512x512 pixels, but 1024x1024 pixels are best. This will allow the compression and scaling algorithms to work correctly, avoiding the appearance of artifacts or blur on devices with high-definition screens.
It is also worth paying attention to the safe zone of the image. Important elements of the logo should not be located too close to the edges, since in adaptive icons part of the image may be cut off by a mask of a circle, square or other shape. Leave small margins around the perimeter so that the composition looks harmonious in any formation.
⚠️ Attention: Avoid using a transparent background for the main icon if you are not sure of the behavior of the system. In some launchers or app settings, transparent areas may appear black or white, which will ruin the appearance of your product.
Use SVG format for the original logo whenever possible - this ensures perfect clarity on any screen, from budget smartphones to flagships with 4K displays.
Running the Image Asset Wizard Studio
The process of replacing an icon begins with accessing a specialized module inside the development environment. You don't need to create resource files manually or edit XML markup. The entire process is automated through a graphical interface, which is launched through the project's context menu.
To begin, open your project in Android Studio and switch to file display mode Project (usually located in the upper left corner of the window). Find the folder res, which contains all the application resources. Inside this directory you need to find the folder mipmap. In modern projects, you will see several folders with suffixes, for example, mipmap-anydpi-v26 and mipmap-hdpi. Right-click on any of the folders mipmap.
In the context menu that appears, select New, and then in the submenu find and click Image Asset. This action will open the wizard window Asset Studio. If you do not see this item, make sure that the resource directory is selected, and not the project root or folder java. The wizard interface is divided into several tabs that allow you to flexibly customize the appearance of the icon.
- 📂 The Legacy tab is designed for creating classic square icons compatible with older versions of Android.
- 🎨 The Foreground tab allows you to customize the foreground of the adaptive icon, which will be visible on top of the mask.
- 🔲 The Background tab is needed to select the color or background image of the adaptive icon.
By default, the wizard opens on the adaptive icon settings tab, since this is the modern standard. However, switching between tabs occurs instantly, allowing you to immediately see how changes affect the final result in the preview window on the right.
Setting up an adaptive icon
Starting with Android version 8.0 (API level 26), the system uses adaptive icons. This means that the shape of the app icon is determined not by the developer, but by the theme chosen by the user on the device. The launcher can crop the icon into a circle, a square, a rounded square, or even a teardrop shape. Your task is to provide a system of layers from which it will form the final image.
In the wizard interface, go to the tab Foreground Layer. Here you can select the type of resource: Image (image), Clip Art (ready-made vectors from the Android library) or Text (text label). The most commonly used mode is Image. Click on the check mark button to upload your prepared logo file. After loading, you will see the image in the center of the work area.
The key parameter here is the slider Resize or Scaling. It allows you to resize the image relative to the safe zone. In the preview window you will see two circles: the inner one (safe zone) and the outer one (crop zone). Make sure all important logo details are inside the inner circle. If the logo is too large, scale it down so that the edges are not cut off when applying the mask.
⚠️ Warning: Do not place critical logo elements (such as title text or small details) close to the edges of the circle. On devices with non-standard masks, these parts may be invisible to the user.
Next, go to the tab Background Layer. Here you can set a solid background color or use a different image. For most applications, the optimal solution is to use a solid color that matches the company's brand book. This provides a clean and tidy icon look on any desktop. Use the eyedropper or enter a HEX code to select the exact shade.
The adaptive icon consists of two independent layers: the foreground with the logo and the background with the color, which allows the system to dynamically change the shape of the icon.
Setting up the classic icon (Legacy Icon)
Despite the dominance adaptive icons, legacy format support is still required for correct display in some system menus, application settings or on devices with older versions of Android. In the Asset Studio wizard, this setting is made on a separate tab or at the bottom of the window, depending on the IDE version.
In the Legacy You also have to select the image source. You can use the same file as for the responsive icon, or download a special version optimized for the square format. Often, developers add small decorative elements to the square version in the corners, which would be cut off in a round adaptive icon mask.
Pay attention to the parameter Trim. If your image has a lot of white space around the logo, enable this option. It will automatically trim off excess transparent fields so that the logo occupies the maximum possible area within the square. This makes the icon more visible and larger on the smartphone screen.
For legacy icons, form customization is also available via a drop-down list Shape. You can choose None (square), Circle (circle) or Square with automatic corner rounding. The choice depends on how you want the icon to look on older devices, where the system does not apply dynamic masks.
Why are both versions needed?
The adaptive icon is used on the home screen of new devices, and the Legacy version can be displayed in the phone settings, in the list of installed applications, or on older smartphones where the API is lower than 26.
Resource generation and file structure
Once you are satisfied with the result in the preview window, click the button Next, and then Finish. The wizard will automatically generate all the necessary files and place them in the appropriate project directories. This stage is critically important, since manually creating dozens of files of different resolutions would take hours.
The system will create the following groups of files:
- 📁 XML files
mipmap-anydpi-v26, which refer to the layers of the adaptive icon.ic_launcher.xmlandic_launcher_round.xmlwill appear in the folder - 🖼️ In the folders
mipmap-hdpi,mipmap-mdpi,mipmap-xhdpiand others, raster PNG files will be saved for different screen densities. - ⚙️ File
AndroidManifest.xmlwill be automatically updated if necessary, although usually links to icons are already written there by default.
It is important to understand the structure of the files. For adaptive icons, the system uses vector drawable resources or links to them. This allows the icon to remain clear at any scale. For older versions of Android, raster copies of fixed sizes are generated to ensure fast rendering without wasting CPU time on scaling.
| Resources folder | Screen density (DPI) | File type | Purpose |
|---|---|---|---|
| mipmap-mdpi | 160 dpi | PNG | Old low-density devices |
| mipmap-hdpi | 240 dpi | PNG | Medium-density devices |
| mipmap-xhdpi | 320 dpi | PNG | Most modern smartphones |
| mipmap-xxhdpi | 480 dpi | PNG | Flagship devices |
| mipmap-anydpi-v26 | Any | XML | Adaptive icons (Android 8.0+). @mipmap/ic_launcher |
☑️ Check after generation
Checking the result and solving problems
After generating the resources, you need to make sure that the icon is displayed correctly. Run the application on an emulator or real device. If the icon has not changed, try clearing the build cache. To do this, select Build -> Clean Projectfrom the menu, and then Rebuild Project. Sometimes Android Studio caches old resources, and a full rebuild solves the problem.
A common error is mismatched file names. Make sure that the file AndroidManifest.xml tag application attribute android:icon refers to the correct resource name. The default is @mipmap/ic_launcher. If you changed the icon name in the Asset Studio wizard, be sure to update this link manually if the automatic update did not work.
It is also worth checking whether the icon is overridden in the style files or application themes. In some cases, developers specify an icon directly in the theme, which takes precedence over the manifest. Use the project search (Ctrl+Shift+F) to find all mentions of the word icon and check the context of their use.
⚠️ Attention: If you use third-party libraries or plugins, they may replace the icon when building. Check your Gradle configuration and plugin settings if standard replacement methods do not work.
For deep debugging, you can use the tool App Inspection or simply view the compiled APK file through the archiver. Inside the APK folder res/mipmap you should see your new images. If there are old files there, then there is a problem at the compilation stage, and you need to check the source paths.
If the icon looks blurry on a specific device, check whether the file was generated for the appropriate screen density (for example, xxhdpi). The absence of a file of the required resolution forces the system to scale a smaller image, degrading the quality.
Why does the icon not change after replacing files?
Most often the problem lies in the IDE or build system cache. Run the command Invalidate Caches / Restart in the File menu. Also make sure that you are not running an old version of the application that is already installed on your device. Try deleting the application from your phone before launching it again.
Can I use an animated icon?
Standard Android Studio tools and resource formats do not support animation for static icons in the launcher. Animation is only possible within the application or in widgets. For the launcher, the icon will always be a static image.
How to make a round icon for older Androids?
In the Asset Studio wizard, on the Legacy tab, select the shape Circle. This will create raster files with corners cropped. However, be aware that on very old versions of Android, the system may ignore this shape and display a square.
Do I need to change the icon in Google Play Console separately?
Yes, the icon in the project and the icon in the store are different entities. In Google Play Console, you need to upload a high resolution image (512x512) in a separate field when publishing a release. Changes to the application code will not automatically update the icon in the store.
What icon size is best for responsive design?
The optimal size of the source vector image is not limited, but for raster PNGs, 1024x1024 pixels is recommended. The main rule: important content should be in the central area with a diameter of 66% of the total width to avoid cropping.