68 lines
1.8 KiB
Markdown
68 lines
1.8 KiB
Markdown
## Building mobile libraries
|
|
|
|
### Prerequisites
|
|
#### protoc
|
|
Install the dependencies for generating protobuf definitions as stated in
|
|
[lnrpc docs]( ../lnrpc/README.md#generate-protobuf-definitions)
|
|
|
|
#### gomobile
|
|
Follow [gomobile](https://github.com/golang/go/wiki/Mobile) in order to install
|
|
`gomobile` and dependencies.
|
|
|
|
Remember to run `gomobile init` (otherwise the `lnd` build might just hang).
|
|
|
|
Note that `gomobile` only supports building projects from `GOPATH` at this
|
|
point.
|
|
|
|
#### falafel
|
|
Install [`falafel`](https://github.com/lightninglabs/falafel):
|
|
```
|
|
go get -u -v github.com/lightninglabs/falafel
|
|
```
|
|
|
|
### Building `lnd` for iOS
|
|
```
|
|
make ios
|
|
```
|
|
|
|
### Building `lnd` for Android
|
|
```
|
|
make android
|
|
```
|
|
|
|
`make mobile` will build both iOS and Android libs.
|
|
|
|
### Libraries
|
|
After the build has succeeded, the libraries will be found in
|
|
`mobile/build/ios/Lndmobile.framework` and
|
|
`mobile/build/android/Lndmobile.aar`. Reference your platforms' SDK
|
|
documentation for how to add the library to your project.
|
|
|
|
#### Generating proto definitions for your language.
|
|
In order to call the methods in the generated library, the serialized proto for
|
|
the given RPC call must be provided. Similarly, the response will be a
|
|
serialized proto.
|
|
|
|
In order to generate protobuf definitions for your language of choice, add the
|
|
proto plugin to the `protoc` invocations found in
|
|
[`gen_protos.sh`](../lnrpc/gen_protos.sh). For instance to generate protos for
|
|
Swift, add `--swift_out=.` and run `make rpc`.
|
|
|
|
### Options
|
|
Similar to lnd, subservers can be conditionally compiled with the build by
|
|
setting the tags argument:
|
|
|
|
```
|
|
make ios tags="routerrpc"
|
|
```
|
|
|
|
To support subservers that have APIs with name conflicts, pass the "prefix"
|
|
flag. This will add the subserver name as a prefix to each method name:
|
|
|
|
```
|
|
make ios tags="routerrpc" prefix=1
|
|
```
|
|
|
|
### API docs
|
|
TODO(halseth)
|