Welcome to the Lawnicons reFilled contributing guide! This file will tell you what you need to know to contribute to Lawnicons reFilled.
Before you start, please fork the project and clone it to your machine. Afterwards, you can either contribute icons or code.
See the below image for a summary of the icon guidelines.
Each icon must fit the 20x20 or 18x18 (depending on the shape) content area size. It must not be smaller nor bigger than the specified sizes.
In addition to the above, the icons must have a filled (not outlined) style.
Here's how to add an icon to Lawnicon reFilled:
- Your icon in the SVG format, adhering to the above guidelines. The filename must use snake case (e.g.
files_by_google.svg
). - The package and activity name of the app.
Please check the icon tool guide for more information.
-
Add the ready SVG to the
svgs
directory. -
Add a new line to
app/assets/appfilter.xml
(in alphabetical order, by thename
attribute), and map the new icon to a package name and app's activity. For example:<item component="ComponentInfo{com.google.android.apps.nbu.files/com.google.android.apps.nbu.files.home.HomeActivity}" drawable="files_by_google" name="Files by Google"/>
A general template is as follows:
<item component="ComponentInfo{[PACKAGE_NAME]/[APP_ACIVITY_NAME]}" drawable="[DRAWABLE NAME]" name="[APP NAME]"/>
-
Done! You're ready to open a pull request. Please set
develop
as the base branch.
- Connect your Android device or emulator to your laptop/desktop PC that has
adb
installed (see this tutorial for more information) and open the app whose details you want to inspect, e.g. Telegram. - Open a new Command Prompt or Terminal window and input
adb devices
. - Finally, type the below-given command to get the information about the currently open application.
For Mac or Linux:
adb shell dumpsys window | grep 'mCurrentFocus'
For Windows:
adb shell dumpsys window | find "mCurrentFocus"
The part before the /
character in the above image, i.e. org.telegram.messenger
, is the package name ([PACKAGE_NAME]
). The part after it, i.e. org.telegram.messenger.DefaultIcon
, is the activity name ([APP_ACIVITY_NAME]
).
- Download IconRequest: Google Play • GitHub.
- Launch IconRequest and tap one of the options:
- UPDATE EXISTING — to copy packages with activities. How to request icons, 22s video.
- REQUEST NEW — to save icon images and packages with activities. This option is better if you are creating icons.
- Select the apps for which youʼd like to request or make icons.
- Copy, save or share.
- Download the Icon Pusher app.
- Launch the app.
- Select the icon(s) you want to upload or select all by pressing the square in the top right. Then press "Send".
- View the packages with the activities for each app on the Icon Pusher website. Please make sure the
drawable="[DRAWABLE NAME]"
matches the icon SVG file name.