Skip to content

A gradle plugin to automate framing android screenshots with devices frames in multiple languages and with multiple screen sizes.

License

Notifications You must be signed in to change notification settings

chemouna/frame-gradle-plugin

Repository files navigation

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.

About

A gradle plugin to automate framing android screenshots with devices frames in multiple languages and with multiple screen sizes.

Resources

License

Stars

Watchers

Forks

Packages

No packages published