Skip to content

Commit 91c7a66

Browse files
authored
Include quick start manual.
1 parent 7f37a07 commit 91c7a66

File tree

1 file changed

+52
-0
lines changed

1 file changed

+52
-0
lines changed

README.md

Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,54 @@
11
# log4j2-android
2+
[![Master Build Status](https://travis-ci.org/Celeral/log4j2-android.svg?branch=master)](https://travis-ci.org/Celeral/log4j2-android/branches)
3+
[![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.celeral/log4j2-android/badge.svg)](http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22com.celeral%22%20AND%20a%3A%22log4j2-android%22)
4+
[![Javadoc](https://javadoc.io/badge/com.celeral/log4j2-android.svg)](https://www.javadoc.io/doc/com.celeral/log4j2-android)
5+
[![Sonatype Nexus (Snapshots)](https://img.shields.io/nexus/s/https/oss.sonatype.org/com.celeral/log4j2-android.svg)](https://oss.sonatype.org/#nexus-search;gav~com.celeral~log4j2-android~~~)
6+
27
Use log4j2 logger with Android projects
8+
# Get it!
9+
10+
Functionality of this package is contained in Java package `com.celeral.android.logging.log4j2`
11+
12+
## Gradle
13+
To use the package, you need to use the following gradle dependency. Note the scope being `runtime` since it's a runtime dependency:
14+
```gradle
15+
dependencies {
16+
runtimeOnly 'com.celeral:log4j2-android:1.0.0'
17+
}
18+
```
19+
20+
## Maven
21+
22+
23+
To use the package, you need to use following Maven dependency. Note the scope being `runtime` since it's a runtime dependency:
24+
25+
```xml
26+
<properties>
27+
...
28+
<!-- Use the latest version whenever possible. -->
29+
<celeral.version.log4j2.android>1.0.0</celeral.version.log4j2.android>
30+
...
31+
</properties>
32+
33+
<dependencies>
34+
...
35+
<dependency>
36+
<groupId>com.celeral</groupId>
37+
<artifactId>log4j2-android</artifactId>
38+
<version>${celeral.version.log4j2.android}</version>
39+
<scope>runtime</scope>
40+
</dependency>
41+
...
42+
</dependencies>
43+
```
44+
45+
or download jars from [Central Maven repository](http://repo1.maven.org/maven2/com/celeral/log4j2-android/).
46+
47+
## Non-Maven
48+
49+
For non-Maven use cases, you download jars from [Central Maven repository](http://repo1.maven.org/maven2/com/celeral/log4j2-android/).
50+
51+
# Special Attention
52+
* Ensure that the dependency you provide is `runtime` or its equivalent
53+
* Ensure that from the final deployment `log4j2-core` is excluded
54+
* Ensure that you are not using the files in this jar anywhere in your code; if you are then there is a chance that you are doing something wrong!

0 commit comments

Comments
 (0)