Add documentation on how to use snapshot versions of libraries

This commit is contained in:
thunderbiscuit
2022-11-30 12:20:48 -05:00
parent 2645f69853
commit 5dd5828e88
3 changed files with 42 additions and 13 deletions

View File

@@ -1,8 +1,8 @@
# bdk-android
This project builds a .jar package for the `jvm` platform that provide [Kotlin] language bindings for the [`bdk`] library. The Kotlin language bindings are created by the [`bdk-ffi`] project which is included in the root of this repository.
This project builds a .jar package for the JVM platform that provide Kotlin language bindings for the [`bdk`] library. The Kotlin language bindings are created by the `bdk-ffi` project which is included in the root of this repository.
## How to Use
To use the Kotlin language bindings for [`bdk`] in your `jvm` project add the following to your gradle dependencies:
To use the Kotlin language bindings for [`bdk`] in your JVM project add the following to your gradle dependencies:
```kotlin
repositories {
mavenCentral()
@@ -32,10 +32,23 @@ val wallet = Wallet(externalDescriptor, internalDescriptor, Network.TESTNET, dat
val newAddress = wallet.getNewAddress()
```
### Example Projects
### Snapshot releases
To use a snapshot release, specify the snapshot repository url in the `repositories` block and use the snapshot version in the `dependencies` block:
```kotlin
repositories {
maven("https://s01.oss.sonatype.org/content/repositories/snapshots/")
}
dependencies {
implementation("org.bitcoindevkit:bdk-jvm:<version-SNAPSHOT>")
}
```
## Example Projects
* [Tatooine Faucet](https://github.com/thunderbiscuit/tatooine)
### How to build
## How to build
_Note that Kotlin version `1.6.10` or later is required to build the library._
1. Clone this repository.
@@ -53,10 +66,8 @@ rustup target add x86_64-apple-darwin aarch64-apple-darwin
./gradlew buildJvmLib
```
## How to publish
### Publish to your local maven repo
## How to publish to your local Maven repo
```shell
# bdk-jvm
cd bdk-jvm
./gradlew publishToMavenLocal --exclude-task signMavenPublication
```
@@ -71,3 +82,6 @@ and use the `publishToMavenLocal` task without excluding the signing task:
```shell
./gradlew publishToMavenLocal
```
[`bdk`]: https://github.com/bitcoindevkit/bdk
[`bdk-ffi`]: https://github.com/bitcoindevkit/bdk-ffi