Skip to content

Add Troubleshooting Android section #585

Add Troubleshooting Android section

Add Troubleshooting Android section #585

Workflow file for this run

name: CI
# Controls when the workflow will run
on:
# Triggers the workflow on push events but only for the "main" and "pre-release" branches
push:
branches: [ main, pre-release ]
pull_request:
# Allows you to run this workflow manually from the Actions tab
workflow_dispatch:
inputs:
sdk-ref:
description: 'sdk commit/tag/branch reference. Defaults to main.'
required: false
type: string
default: main
concurrency:
group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
cancel-in-progress: true
jobs:
setup:
name: setup
runs-on: ubuntu-latest
outputs:
sdk-ref: ${{ inputs.sdk-ref || '0.4.0' }}
package-version: '0.4.0'
steps:
- run: echo "set pre-setup output variables"
build-packages:
needs: setup
name: build packages
uses: breez/breez-sdk/.github/workflows/publish-all-platforms.yml@main
with:
repository: breez/breez-sdk
ref: ${{ needs.setup.outputs.sdk-ref }}
package-version: ${{ needs.setup.outputs.package-version }}
packages-to-publish: '["csharp", "flutter", "golang", "react-native", "python"]'
use-dummy-binaries: true
check-rust:
needs: setup
name: Check rust snippets
runs-on: ubuntu-latest
steps:
- name: Checkout repo
uses: actions/checkout@v3
# Set up Rust environment and run checks
- name: Install rust
run: |
rustup set auto-self-update disable
rustup toolchain install stable --profile minimal
- name: Install Protoc
uses: arduino/setup-protoc@v2
with:
version: "23.4"
repo-token: ${{ secrets.GITHUB_TOKEN }}
- uses: Swatinem/rust-cache@v2
with:
workspaces: snippets/rust -> snippets/rust/target
- name: temporarily get sdk
uses: actions/checkout@v3
with:
repository: breez/breez-sdk
ref: ${{ needs.setup.outputs.sdk-ref }}
path: breez-sdk
- id: rev-parse
name: get proper rev
working-directory: breez-sdk
run: |
rev=$(git rev-parse HEAD)
echo "$rev"
echo "rev=$rev" >> $GITHUB_OUTPUT
- name: set sdk version
working-directory: snippets/rust
run: |
cargo add --git https://github.com/breez/breez-sdk.git breez-sdk-core --rev "${{ steps.rev-parse.outputs.rev }}"
- name: clippy
working-directory: snippets/rust
run: |
# Explicitly allow clippy::dead_code lint because the functions aren't called in the docs snippets
# Explicitly allow clippy::unused_variables because snippets might have to demonstrate how to get certain variables without using them afterward
cargo clippy -- --allow dead_code --allow unused_variables --deny warnings
check-dart:
needs:
- setup
- build-packages
name: Check dart snippets
runs-on: ubuntu-latest
steps:
- name: Checkout repo
uses: actions/checkout@v3
# Set up the flutter environment and run checks
- uses: subosito/flutter-action@v2
with:
channel: 'stable'
cache: true
- uses: actions/download-artifact@v3
with:
name: breez-sdk-flutter-${{ needs.setup.outputs.package-version }}
path: snippets/dart_snippets/packages/breez-sdk-flutter
- name: pub-get
working-directory: snippets/dart_snippets
run: flutter pub get
- name: dart-analyze
working-directory: snippets/dart_snippets
run: dart analyze --fatal-infos
check-csharp:
needs:
- setup
- build-packages
name: Check C# snippets
runs-on: ubuntu-latest
steps:
- name: Checkout repo
uses: actions/checkout@v3
- name: Setup dotnet
uses: actions/setup-dotnet@v3
with:
dotnet-version: '7.0.x'
- name: Download archived package
uses: actions/download-artifact@v3
with:
name: Breez.Sdk.${{ needs.setup.outputs.package-version }}.nupkg
path: .
- name: Create nuget package source
working-directory: snippets/csharp
run: |
mkdir packages
nuget add ../../Breez.Sdk.${{ needs.setup.outputs.package-version }}.nupkg -Source ./packages
- name: Add nuget dependency
working-directory: snippets/csharp
run: |
dotnet add package Breez.Sdk -s ./packages --prerelease
- name: Build the csharp project
working-directory: snippets/csharp
run: dotnet build
check-react-native:
needs:
- setup
- build-packages
name: Check react native snippets
runs-on: ubuntu-latest
steps:
- name: Checkout repo
uses: actions/checkout@v3
- name: Set Node.js 20.x
uses: actions/setup-node@v3
with:
node-version: 20.x
- name: Download archived package
uses: actions/download-artifact@v3
with:
name: react-native-${{ needs.setup.outputs.package-version }}
path: snippets/react-native/packages
- name: Install dependencies
working-directory: snippets/react-native
run: yarn
- name: Check syntax
working-directory: snippets/react-native
run: tsc
- name: Check formatting
working-directory: snippets/react-native
run: yarn run lint
check-golang:
needs:
- setup
- build-packages
name: Check Go snippets
runs-on: ubuntu-latest
steps:
- name: Checkout repo
uses: actions/checkout@v3
- uses: actions/setup-go@v4
with:
go-version: '1.21'
- name: Download archived package
uses: actions/download-artifact@v3
with:
name: breez-sdk-go-${{ needs.setup.outputs.package-version }}
path: snippets/go/packages/breez-sdk-go
- name: Format the Go snippets
working-directory: snippets/go
run: go fmt
- name: Test formatted correctly
working-directory: snippets/go
run: |
status=$(git status --porcelain)
if [[ -n "$status" ]]; then
echo "Git status has changes"
echo "$status"
git diff
exit 1
else
echo "No changes in git status"
fi
- name: Build the Go snippets
working-directory: snippets/go
run: |
go get
go build .
check-python:
needs:
- build-packages
name: Check Python snippets
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Set up Python
uses: actions/setup-python@v4
with:
python-version: '3.8'
- name: Download archived package
uses: actions/download-artifact@v3
with:
name: python-wheel-3.8-manylinux_2_31_x86_64
path: snippets/python/packages
- name: Install dependencies
working-directory: snippets/python
run: |
python -m pip install --upgrade pip
pip install ruff
whlfile=$(ls packages | grep .whl)
pip install "packages/$whlfile"
- name: Check python formatting
working-directory: snippets/python/src
run: ruff check --ignore F841 --ignore F401 --add-noqa .
- name: Check python syntax
working-directory: snippets/python
run: python3 -m compileall src
check-swift:
name: Check Swift snippets
runs-on: macos-13
steps:
- uses: actions/checkout@v4
- name: Set up Swift
uses: swift-actions/setup-swift@v1
with:
swift-version: "5"
- name: Build
working-directory: snippets/swift/BreezSDKExamples
run: |
swift build
check-kotlin:
needs: setup
name: Check kotlin MPP snippets
runs-on: ubuntu-latest
steps:
- name: Checkout repo
uses: actions/checkout@v3
- name: Set up Java 17
uses: actions/setup-java@v2
with:
distribution: "temurin"
java-version: 17
- name: Compile Kotlin
working-directory: snippets/kotlin_mpp_lib
run: |
./gradlew build
build:
name: Build mdbook
runs-on: ubuntu-latest
steps:
- name: Checkout repo
uses: actions/checkout@v3
- name: Install rust
run: |
rustup set auto-self-update disable
rustup toolchain install stable --profile minimal
- uses: Swatinem/rust-cache@v2
with:
workspaces: |
. -> target
snippets-processor -> snippets-processor/target
- name: Install dependencies
run: |
cargo install mdbook --vers "^0.4" --locked
cargo install --path ./snippets-processor
- name: Build mdbook
run: mdbook build
- name: Archive book
uses: actions/upload-artifact@v3
with:
name: book
path: book
- name: Push book to main-generated branch
if: ${{ github.event_name == 'push' && github.ref == 'refs/heads/main' }}
run: |
git config --global user.name "Generator"
git config --global user.email "[email protected]"
git add -f book
git commit -m "Generate documentation"
git push origin --force main:main-generated
- name: Push book to pre-release-generated branch
if: ${{ github.event_name == 'push' && github.ref == 'refs/heads/pre-release' }}
run: |
git config --global user.name "Generator"
git config --global user.email "[email protected]"
git add -f book
git commit -m "Generate documentation"
git push origin --force pre-release:pre-release-generated