2014-09-08 21:33:33 +08:00
|
|
|
# NOTICE: The Cask syntax is changing! (8 Sep 2014)
|
|
|
|
|
|
|
|
There will be a period of transition while we update the Cask DSL to use
|
2014-09-09 00:50:51 +08:00
|
|
|
new forms described in [#4688](https://github.com/caskroom/homebrew-cask/issues/4688).
|
|
|
|
|
|
|
|
End users should not notice a difference — but see below about upgrading
|
|
|
|
on errors. Cask authors will need to adjust to the new DSL forms.
|
2014-09-08 21:33:33 +08:00
|
|
|
|
|
|
|
The Cask DSL 1.0 will be documented in [CASK_LANGUAGE_REFERENCE.md](doc/CASK_LANGUAGE_REFERENCE.md)
|
2014-09-09 00:50:51 +08:00
|
|
|
and [cask_language_deltas.md](doc/cask_language_deltas.md).
|
2014-09-08 21:33:33 +08:00
|
|
|
|
|
|
|
Code to support most of the new DSL forms has been in release for several
|
|
|
|
weeks; most users are already running forward compatible code<sup>1</sup>.
|
|
|
|
|
2014-09-09 00:50:51 +08:00
|
|
|
The transition officially begins with version 0.40.0, released 8 Sep 2014.
|
|
|
|
Cask definition files will also be changing. If you experience an error
|
|
|
|
when running Homebrew-cask, please run
|
2014-09-08 21:33:33 +08:00
|
|
|
|
|
|
|
```bash
|
|
|
|
$ brew update && brew upgrade brew-cask && brew cleanup && brew cask cleanup
|
|
|
|
```
|
|
|
|
|
2014-09-09 00:50:51 +08:00
|
|
|
to get the latest code.
|
|
|
|
|
2014-09-08 21:33:33 +08:00
|
|
|
<sup>1</sup> forward compatibility began with [v0.38.0](https://github.com/caskroom/homebrew-cask/releases/tag/v0.38.0), released 28 Jul 2014
|
|
|
|
|
|
|
|
---------------------------------------
|
|
|
|
|
|
|
|
|
2012-03-05 10:46:30 +08:00
|
|
|
# "To install, drag this icon..." no more!
|
|
|
|
|
2014-05-03 23:16:12 +08:00
|
|
|
[![Build Status](https://travis-ci.org/caskroom/homebrew-cask.png?branch=master)](https://travis-ci.org/caskroom/homebrew-cask)
|
|
|
|
[![Code Climate](https://codeclimate.com/github/caskroom/homebrew-cask.png)](https://codeclimate.com/github/caskroom/homebrew-cask)
|
|
|
|
[![Bitdeli Badge](https://d2weczhvl823v0.cloudfront.net/caskroom/homebrew-cask/trend.png)](https://bitdeli.com/free "Bitdeli Badge")
|
2013-08-13 05:03:06 +08:00
|
|
|
|
2013-04-05 16:10:59 +08:00
|
|
|
|
2012-03-05 10:46:30 +08:00
|
|
|
Let's see if we can get the elegance, simplicity, and speed of Homebrew for the
|
2013-12-08 02:16:58 +08:00
|
|
|
installation and management of GUI Mac applications such as Google Chrome and Adium.
|
2012-03-05 10:46:30 +08:00
|
|
|
|
2014-01-18 09:14:48 +08:00
|
|
|
Homebrew-cask provides a friendly homebrew-style CLI workflow for the
|
2012-03-05 10:46:30 +08:00
|
|
|
administration of Mac applications distributed as binaries.
|
|
|
|
|
2014-09-08 21:33:33 +08:00
|
|
|
It's implemented as a `homebrew` "[external command](https://github.com/mxcl/homebrew/wiki/External-Commands)"
|
|
|
|
called `cask`.
|
2012-03-05 10:46:30 +08:00
|
|
|
|
2013-04-29 03:20:03 +08:00
|
|
|
## Let's try it!
|
2013-09-19 23:14:57 +08:00
|
|
|
```sh
|
2014-07-21 13:52:11 +08:00
|
|
|
$ brew install caskroom/cask/brew-cask
|
2013-09-19 23:14:57 +08:00
|
|
|
$ brew cask install google-chrome
|
|
|
|
=> Downloading https://dl.google.com/chrome/mac/stable/GGRO/googlechrome.dmg
|
|
|
|
=> Success! google-chrome installed to /opt/homebrew-cask/Caskroom/google-chrome/stable-channel
|
|
|
|
=> Linking Google Chrome.app to /Users/phinze/Applications/Google Chrome.app
|
|
|
|
```
|
2013-12-08 02:16:58 +08:00
|
|
|
And there we have it. Google Chrome installed with a few quick commands: no clicking, no dragging, no dropping.
|
2013-09-19 23:14:57 +08:00
|
|
|
```sh
|
2014-09-16 20:30:12 +08:00
|
|
|
$ open ~/Applications/"Google Chrome.app"
|
2013-09-19 23:14:57 +08:00
|
|
|
```
|
2013-04-29 03:20:03 +08:00
|
|
|
## Learn More
|
2012-10-11 02:55:24 +08:00
|
|
|
|
2014-01-18 09:14:48 +08:00
|
|
|
* Find basic documentation on using homebrew-cask in [USAGE.md](USAGE.md)
|
2014-01-19 00:20:29 +08:00
|
|
|
* Want to contribute a Cask? Awesome! See [CONTRIBUTING.md](CONTRIBUTING.md)
|
2014-03-01 21:24:24 +08:00
|
|
|
* Want to hack on our code? Also awesome! See [HACKING.md](doc/HACKING.md)
|
|
|
|
* More project-related details and discussion are available in [FAQ.md](doc/FAQ.md) and [CASK_LANGUAGE_REFERENCE.md](doc/CASK_LANGUAGE_REFERENCE.md)
|
2013-07-09 22:30:07 +08:00
|
|
|
|
|
|
|
## Questions? Wanna chat?
|
|
|
|
|
|
|
|
We're really rather friendly! Here are the best places to talk about the project:
|
|
|
|
|
2014-05-03 23:16:12 +08:00
|
|
|
* Start an [issue on GitHub](https://github.com/caskroom/homebrew-cask/issues/new)
|
2013-07-09 22:30:07 +08:00
|
|
|
* Join us on IRC, we're at `#homebrew-cask` on Freenode
|
2013-09-23 02:37:18 +08:00
|
|
|
|
2014-01-27 23:45:24 +08:00
|
|
|
## Reporting Bugs
|
|
|
|
|
|
|
|
We still have bugs -- and we are busy fixing them! If you have a problem, don't
|
2014-05-03 23:16:12 +08:00
|
|
|
be shy about reporting it on our [GitHub issues page](https://github.com/caskroom/homebrew-cask/issues?state=open).
|
2014-01-27 23:45:24 +08:00
|
|
|
|
|
|
|
When reporting bugs, remember that homebrew-cask is an independent project from
|
|
|
|
Homebrew. Do your best to direct bug reports to the appropriate project. If
|
|
|
|
your command-line started with `brew cask`, bring the bug to us first!
|
|
|
|
|
2014-02-21 21:58:19 +08:00
|
|
|
Before reporting a bug, make sure you have the latest versions of Homebrew,
|
|
|
|
homebrew-cask, and all Taps by running the following command:
|
|
|
|
|
|
|
|
```bash
|
2014-06-14 20:39:58 +08:00
|
|
|
$ brew update && brew upgrade brew-cask && brew cleanup && brew cask cleanup
|
2014-02-21 21:58:19 +08:00
|
|
|
```
|
|
|
|
|
2013-09-23 02:37:18 +08:00
|
|
|
## License:
|
2014-01-07 16:08:08 +08:00
|
|
|
Code is under the [BSD 2 Clause (NetBSD) license](LICENSE)
|