Merge pull request #1044 from ryanseys/dev

Clean up README.md
This commit is contained in:
ojw28 2015-12-10 17:50:12 +00:00
commit f926d6a67e

View File

@ -1,6 +1,4 @@
# ExoPlayer Readme # # ExoPlayer #
## Description ##
ExoPlayer is an application level media player for Android. It provides an ExoPlayer is an application level media player for Android. It provides an
alternative to Androids MediaPlayer API for playing audio and video both alternative to Androids MediaPlayer API for playing audio and video both
@ -10,6 +8,42 @@ adaptive playbacks. Unlike the MediaPlayer API, ExoPlayer is easy to
customize and extend, and can be updated through Play Store application customize and extend, and can be updated through Play Store application
updates. updates.
## Installation ##
### via jCenter ###
The easiest way to get started using ExoPlayer in your Android project is by including this your `build.gradle` file:
```gradle
compile 'com.google.android.exoplayer:exoplayer:rX.X.X'
```
where `rX.X.X` is the your preferred version. For the latest version, see the project's [Releases](https://github.com/google/ExoPlayer/releases).
For more details, see the project on [jCenter](https://bintray.com/google/exoplayer/exoplayer/view).
### via source ###
ExoPlayer can also be built from source using Gradle. You can include it as a dependent project like so:
```gradle
// settings.gradle
include ':app', ':..:ExoPlayer:library'
// app/build.gradle
dependencies {
compile project(':..:ExoPlayer:library')
}
```
If you want to use ExoPlayer as a jar, run:
```sh
./gradlew jarRelease
```
and copy `library.jar` to the libs folder of your new project.
## News ## ## News ##
Read news, hints and tips on the [news][] page. Read news, hints and tips on the [news][] page.
@ -29,8 +63,8 @@ started.
## Project branches ## ## Project branches ##
* The [master][] branch holds the most recent minor release. * The [`master`][master] branch holds the most recent minor release.
* Most development work happens on the [dev][] branch. * Most development work happens on the [`dev`][dev] branch.
* Additional development branches may be established for major features. * Additional development branches may be established for major features.
[master]: https://github.com/google/ExoPlayer/tree/master [master]: https://github.com/google/ExoPlayer/tree/master
@ -43,42 +77,10 @@ accompanying demo application. To get started:
1. Install Eclipse and setup the [Android SDK][]. 1. Install Eclipse and setup the [Android SDK][].
1. Open Eclipse and navigate to File->Import->General->Existing Projects into 1. Open Eclipse and navigate to File->Import->General->Existing Projects into Workspace.
Workspace.
1. Select the root directory of the repository. 1. Select the root directory of the repository.
1. Import the ExoPlayerDemo and ExoPlayerLib projects. 1. Import the ExoPlayerDemo and ExoPlayerLib projects.
[Android SDK]: http://developer.android.com/sdk/index.html [Android SDK]: http://developer.android.com/sdk/index.html
## Using Gradle ##
ExoPlayer can also be built using Gradle. You can include it as a dependent project and build from source:
```
// settings.gradle
include ':app', ':..:ExoPlayer:library'
// app/build.gradle
dependencies {
compile project(':..:ExoPlayer:library')
}
```
If you want to use ExoPlayer as a jar, run:
```
./gradlew jarRelease
```
and copy library.jar to the libs-folder of your new project.
The project is also available on [jCenter](https://bintray.com/google/exoplayer/exoplayer/view):
```
compile 'com.google.android.exoplayer:exoplayer:rX.X.X'
```
Where `rX.X.X` should be replaced with the desired version.