cesarferreira/dryrun

★ 3,795RubyAudience · developerComplexity · 2/5LicenseSetup · moderate

Mindmap

mindmap
  root((Dryrun))
    What it does
      Run Android demos instantly
      Single command workflow
      No manual cleanup
    Setup
      Ruby gem install
      Android SDK required
      ANDROID_SDK_ROOT env var
    Options
      Branch or tag selection
      Custom module choice
      Run instrumented tests
    Audience
      Android developers
      Library evaluators

mindmap root((Dryrun)) What it does Run Android demos instantly Single command workflow No manual cleanup Setup Ruby gem install Android SDK required ANDROID_SDK_ROOT env var Options Branch or tag selection Custom module choice Run instrumented tests Audience Android developers Library evaluators

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Test an Android library's demo app instantly from its GitHub URL without opening Android Studio.

USE CASE 2

Evaluate multiple Android libraries quickly by running their example apps back-to-back from the terminal.

USE CASE 3

Try a specific branch or release tag of an Android library before adding it to your project.

Tech stack

RubyAndroid SDKGit

Getting it running

Difficulty · moderate Time to first run · 30min

Requires Android SDK installed with ANDROID_SDK_ROOT set correctly, on Windows, Git must also be on the system PATH.

MIT license, use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

Dryrun is a command-line tool for Android developers who want to quickly test a library project hosted on GitHub without going through the full setup process. Normally, trying out an Android library means downloading a zip file, extracting it, opening Android Studio, importing the project, syncing dependencies, and then running it, a process that can take several minutes and leaves files to clean up afterward. Dryrun collapses this into a single command. You give it a GitHub URL, and within a few seconds the example app for that library is running on a connected Android device or emulator. When you are done, there is nothing to clean up. The tool handles downloading, building, and deploying the demo app without any manual steps. The tool is written in Ruby and installed as a Ruby gem. It requires the Android SDK to be available on your machine, with the ANDROID_SDK_ROOT environment variable set correctly. On Windows, Git must also be on the system path. Beyond those prerequisites, setup is minimal. Additional options let you specify a particular branch, tag, or commit hash to test, choose a custom module if the repo contains more than one, set a build flavor, or run Android instrumented tests. Private GitHub repositories are also supported by using an SSH-style Git URL. The project is open-source under the MIT license, created by Cesar Ferreira as a time-saving utility for Android developers who evaluate many libraries. It is a standalone developer tool rather than a library itself.

Copy-paste prompts

Prompt 1

I want to try the demo app for an Android library at github.com/owner/repo. How do I use Dryrun to run it on my emulator with one command?

Prompt 2

How do I use Dryrun to test a specific branch of an Android library, not just the default branch?

Prompt 3

Dryrun can't find my Android SDK. How do I set ANDROID_SDK_ROOT correctly on macOS or Linux?

Open on GitHub → Explain another repo

← cesarferreira on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.