Skip to content

ares - utility for unpacking android drawable resources by dpi

Notifications You must be signed in to change notification settings

akkalomator/ares

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ares - a useful utility for dealing with android png resources for unix

ares copies all files annotated with suffixes to your project resource folder. For example, you have icon.zip file which contains following files:

ares will make them appear in your project res/drawable-<resolution> folders as icon.png

How to use

  1. Download script

    • Optional: run ares_install:
      chmod +x ./ares_install.py
      ./ares_install.py
      
  2. Setup. Do this once and you will never have to do this again.

    In your console type

    ares profile -a <PROFILE_NAME> <RESOURCE_DIRECTORY> \
     [--ldpi <ldpi_SUFFIX>] \
     [--mdpi <mdpi_SUFFIX>] \
     [--hdpi <hdpi_SUFFIX>] \
     [--xhdpi <xhdpi_SUFFIX>] \
     [--xxhdpi <xxhdpi_SUFFIX>]  \
     [--xxxhdpi <xxxhdpi_SUFFIX>] \
     [--nodpi <nodpi_SUFFIX>] \
     [--tvdpi <tvdpi_SUFFIX>]
    
    • <PROFILE_NAME> is is a string alias for your profile. You can create different profiles and switch between them using

      ares unpack -p <PROFILE_NAME>

      As you create new profile, it will become active immediately

    • <RESOURCE_DIRECTORY> is res folder in your project

    • All suffixes are optional. You may specify ones you like. Suffixes that you omit will be ignored

  3. Type

    ares unpack <PATH_TO_ZIP> [-n <NEW_FILES_NAME>]
    

    Files from zip will appear in your project! If you specify -n, files will be renamed

    You can also type

    ares unpack -p <PROFILE_NAME> <PATH_TO_ZIP> -n <NEW_FILES_NAME>
    

    to change profile on the fly. It will be selected as active for future

Example

ares profile -a pet_project ~/dev/my_pet_project/app/src/main/res \
 --mdpi @1x \
 --xhdpi @2x \
 --xxhdpi @3x

Now download resources in zip (i.e. using Figma export) and unpack it

ares unpack ~Downloads/icon.zip -n icon

All functions

  • ares profile -a <PROFILE_NAME> <RESOURCE_DIRECTORY> [SUFFIXES] - adds profile
  • ares profile -l - prints all profiles
  • ares profile -d <PROFILE_NAME> - removes profile if it is not active
  • ares unpack -p - change profile
  • ares unpack <PATH_TO_ZIP> [-n FILE_NAME] - unpacks resources

Releases

No releases published

Packages

No packages published

Languages