Skip to content

Commit be27874

Browse files
Create README.md
1 parent 36a53c8 commit be27874

File tree

1 file changed

+36
-0
lines changed

1 file changed

+36
-0
lines changed

README.md

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
### libsession-util Android bridging code
2+
3+
This repository contains the bridging code allowing the Java/Kotlin client to access to the [libsession-util](https://github.com/session-foundation/libsession-util/) library.
4+
5+
#### Quick start
6+
7+
To start using this library, add this into your top level `build.gradle`'s repository settings
8+
9+
```gradle
10+
maven {
11+
url uri("https://oxen.rocks/session-foundation/libsession-util-android/maven")
12+
content {
13+
includeGroup('org.sessionfoundation')
14+
}
15+
}
16+
```
17+
18+
Then in your app's `build.gradle', you can add this as dependency:
19+
20+
```gradle
21+
implementation 'org.sessionfoundation:libsession-util-android:LATEST_VERSION_NUMBER'
22+
```
23+
24+
All tags pushed to this repository will be built and you can find out the latest by visiting https://github.com/session-foundation/libsession-util-android/tags
25+
26+
#### Versioning
27+
28+
This library's versioning rules are:
29+
1. If there is a tag related to this commit, the tag will be used as the version name
30+
2. Otherwise, the version name will look like "lastGitTag-numberOfChangesSinceLastTag-shortCommitHash", for example "1.0.0-5-abcd12345". "-dirty" will be appended if the git workspace contains uncommitted changes.
31+
32+
Normally you don't have to worry about versioning as it's fully automatic and determinstic. If changes warrant a new release, then Session devs should push a tag and we'll have a formal release version built.
33+
34+
#### Development & deployment
35+
36+
Everyone's welcome to open a Pull Request. However, in order to push any build artifact to `oxen.rocks`, the changes have to come from either the merge of a PR, or the PRs to be opened directly in this repo, as per permission setup of our CI.

0 commit comments

Comments
 (0)