Code Monkey home page Code Monkey logo

sbt-native-packager's Introduction

SBT Native Packager

Service Status Description
Travis Build Status Universal, Debian, Rpm and Jar tests
Appveyor Build status Windows tests
Codacy Codacy Badge Code Quality
Bintray Download Latest Version on Bintray
Gitter Join the chat at https://gitter.im/sbt/sbt-native-packager Chatroom
Issuestats Issue Stats
Issuestats Issue Stats

This is a work in progress project. The goal is to be able to bundle up Scala software built with SBT for native packaging systems, like deb, rpm, homebrew, msi.

Announcement - 1.0.0 will require Java 7 or higher

The next release will require java 7 or higher. If you need java 6, please join the discussion in #498.

Issues/Discussions

  • Discussion/Questions: If you wish to ask questions about the native packager, we have a mailinglist and we're very active on Stack Overflow. You can either use the sbt tag or the sbt-native-packager tag. They also have far better search support for working around issues.
  • Docs: Our docs are available online. If you'd like to help improve the docs, they're part of this repository in the src/sphinx directory. ScalaDocs are also available.
  • Issues/Feature Requests: Finally, any bugs or features you find you need, please report to our issue tracker. Please check the compatibility matrix to see if your system is able to produce the packages you want.

Features

  • Build native packages for different systems
    • Universal zip,tar.gz, xz archives
    • deb and rpm packages for Debian/RHEL based systems
    • dmg for OSX
    • msi for Windows
    • docker images
  • Provide archetypes for common use cases
  • Java application with startscripts for linux/osx/windows
  • Java server additional autostart configurations

Installation

Add the following to your project/plugins.sbt file:

// for autoplugins
addSbtPlugin("com.typesafe.sbt" % "sbt-native-packager" % "1.0.6")

In your build.sbt enable the plugin you want. For example the JavaAppPackaging.

enablePlugins(JavaAppPackaging)

For non-autoplugins use the 0.8.0 version.

addSbtPlugin("com.typesafe.sbt" % "sbt-native-packager" % "0.8.0")

For the native packager keys add this to your build.sbt if you use the a version before 1.0.0

import NativePackagerKeys._

Experimental systemd bootsystem support

Native packager now provides experimental systemd startup scripts. Currently it works on Fedora Fedora release 20 (Heisenbug) and doesn't work on Ubuntu because of partial systemd support in Ubuntu 14.04 LTS. To enable this feature follow My First Packaged Server Project guide and use Systemd as server loader:

import com.typesafe.sbt.packager.archetypes.ServerLoader.Systemd
serverLoading in Rpm := Systemd

Any help on testing and improving this feature is appreciated so feel free to report bugs or making PR.

Experimental Native Packages via javapackager

JDK 8 from Oracle includes the tool javapackager (née javafxpackager) to generate application launchers and native installers for MacOS X, Windows, and Linux. This plugin complements the existing sbt-native-packager formats by taking the settings and staged output from JavaAppPackaging and passing them through javapackager.

This plugin's most significant complement to the core sbt-native-packager capabilities is the generation of MacOS X App bundles, and associated .dmg and .pkg package formats. It can also generate Windows .exe and .msi installers provided the requisite tools are available on the Windows build platform.

For usage details see the JDKPackager Plugin guide.

Documentation

There's a complete "getting started" guide and more detailed topics available at the sbt-native-packager site.

Please feel free to contribute documentation, or raise issues where you feel it may be lacking.

Related SBT Plugins

sbt-native-packager's People

Contributors

muuki88 avatar jsuereth avatar kardapoltsev avatar dwhjames avatar aparkinson avatar fiadliel avatar huntc avatar fsat avatar nazoking avatar jkutner avatar jroper avatar artempyanykh avatar antonini avatar myyk avatar rfranco avatar dhardy92 avatar ezzarghili avatar mhamrah avatar ivanfrain avatar spigene avatar tartakynov avatar dbathily avatar francisdb avatar hfs avatar laguiz avatar yanns avatar mtye avatar nremond avatar ptrbrtz avatar gbougeard avatar

Watchers

James Cloos avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.