All Projects → chemouna → Frame Gradle Plugin

chemouna / Frame Gradle Plugin

Licence: apache-2.0
A gradle plugin to automate framing android screenshots with devices frames in multiple languages and with multiple screen sizes.

Programming Languages

groovy
2714 projects

Gradle Frame Android screenshots Plugin

License

Automate putting your screenshots quickly into Android device frames with their titles.

Usage

brew install imagemagick

and ghostscript for the text :

brew install gs
  • Add the following to your app's build.gradle file: (use the new plugin syntax for gradle 2.1+)

    buildscript {
       repositories {
          maven {
            url "https://plugins.gradle.org/m2/"
          }
       }
    }
    
    plugins {
      id "com.mounacheikhna.screenshots.frame" version "0.2.2"
    }
    

    or Add a maven dependency :

    <dependency>
      <groupId>com.mounacheikhna.screenshots</groupId>
      <artifactId>frame-gradle-plugin</artifactId>
      <version>0.2.2</version>
    </dependency>
    

    or Gradle < 2.1 dependency

    buildscript {
        repositories {
            mavenCentral()
        }
    
        dependencies{
            classpath 'com.mounacheikhna.screenshots:frame-gradle-plugin:0.1.13'
        }
    }    
    
  • Configure the plugin in your app's build.gradle file :

    frames {
        inputDir = "screenshots"
        outputDir = "output"
        framesDir = "frames"
        selectedFrame = "galaxy_nexus_port_back.png"
        localTitlesMap =  [
                "en_US": ["from": "Example screenshot title #1", "to": "Example screenshot title #2"],
                "fr_FR": ["from": "Exemple pour titre screenshot #1", "to": "Exemple pour titre screenshot #2"]
        ]
        backgroundColor = "#00cccc"
        textColor = "#FFFFFF"
        textSize = 40
        topOffset = 40
    }
    

Sample

See sample project for how to set.

Here's a sample result for screenshots for my app Alias :

Contributing

  • Check for open issues or open a fresh issue to start a discussion around a feature idea or a bug.
  • Fork the repository on Github to start making your changes.
  • Send a pull request and bug the maintainer until it gets merged and published. :) Make sure to add yourself to CONTRIBUTORS.txt.

License

Copyright (C) 2016 Mouna Cheikhna

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].