Image Asset Generation Plug-in for Generator (with iOS Image Sets and Android dp support)

This fork adds support for:

• the Android "dp" unit, i.e. it creates images for different screen densities in the corresponding "drawable-" directories.
• the iOS "is" unit, i.e. it creates an asset catalog image set.

Installation

Choose one of the following methods to get it working:

• Deploy into Photoshop:
  • Download the zip file
  • Extract it into /Applications/Adobe Photoshop CC/Plug-ins/Generator/ (Mac), or Program Files/Adobe Photoshop CC/Plugin-ins/Generator... on Windows.
    • the resulting directory is /Applications/Adobe Photoshop CC/Plug-ins/Generator/generator-assets-android-ios
  • Re-launch Photoshop
• Development mode: follow the tutorial here and run npm install inside the directory generator-assets-android-ios.

Usage

Turn on generation in Photoshop by going to File->Generate->Image Assets (iOS & Android).

If you change the name of a layer or layer group to something like 20x20dp ic_ab_search.png, you'll get:

And if you change the name of a layer or layer group to something like 20x20is test.png, you'll get:

and the iOS Contents.json file will look like this, so you'll have generated files for iPhone, iPhone retina, iPad, and iPad retina.

{
  "images": [
    {
      "idiom": "iphone",
      "scale": "1x",
      "fileName": "test.png"
    },
    {
      "idiom": "iphone",
      "scale": "2x",
      "fileName": "[email protected]"
    },
    {
      "idiom": "ipad",
      "scale": "1x",
      "fileName": "[email protected]"
    },
    {
      "idiom": "ipad",
      "scale": "2x",
      "fileName": "test@2x~ipad.png"
    }
  ],
  "info": {
    "version": 1,
    "author": "Photoshop Generator iOS"
  }
}

You can continue to use the existing Generator naming conventions as well.

Below is the README in the original repo

Image Asset Generation Plug-in for Generator

This repository contains a plug-in for Adobe Photoshop CC's Generator extensibility layer. This plug-in makes it easier for users to export image assets from their Photoshop files. Users simply enable image asset generation for a document and name layers (or layer groups, or smart objects) they want exported using a filename-like syntax. Generator then watches these layers, and any time they change, automatically updates the corresponding assets on disk.

To learn more about Generator and creating your own Generator plug-ins, please visit the Generator Core repo.

Usage

The Functional Spec provides basic information about how to use the Image Assets plug-in. Another good source of information is Samartha Vashishtha's blog post A closer look at the Photoshop Generator syntax.

Configuration

For the brave, this plug-in supports a number of experimental configuration options. They're documented here: https://github.com/adobe-photoshop/generator-assets/wiki/Configuration-Options

For details on how to create a configuration file, please see the documentation here: https://github.com/adobe-photoshop/generator-core/wiki/Generator-Configuration-File-Format

License

(MIT License)

Copyright (c) 2013 Adobe Systems Incorporated. All rights reserved.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.