textiot

A framework for building web and native (IoT) Dapps on the IPFS network.

An monorepo textiot.git was combined with https://github.com/textileio/go-textile and related git repos for easier development.

Usage

react-native

npm install textiot --save

For RN < 0.60, run react-native link textiot.

For RN < 0.60 or >= 0.60, then:

Android

Add below into android/settings.gradle

androidx not android:

include ':textile-pb'
project(':textile-pb').projectDir = new File(rootProject.projectDir, '../node_modules/textiot/android-textile/pb-androidx')
include ':textile-mobile'
project(':textile-mobile').projectDir = new File(rootProject.projectDir, '../node_modules/textiot/android-textile/mobile')
include ':android-textile'
project(':android-textile').projectDir = new File(rootProject.projectDir, '../node_modules/textiot/react-native-sdk/textile-androidx')

and cd node_modules/textiot; ./android2androidx.sh

android not androidx:

include ':textile-pb'
project(':textile-pb').projectDir = new File(rootProject.projectDir, '../node_modules/textiot/android-textile/pb-android')
include ':textile-mobile'
project(':textile-mobile').projectDir = new File(rootProject.projectDir, '../node_modules/textiot/android-textile/mobile')
include ':android-textile'
project(':android-textile').projectDir = new File(rootProject.projectDir, '../node_modules/textiot/react-native-sdk/textile-android')

and cd node_modules/textiot; ./androidx2android.sh

require('textiot/react-native-sdk').default;

Because can not npm publish full 300MB package, so you have to install tools described below and

cd node_modules/textiot/
./build-post-npm.sh

results:

go-textile/textile
go-textile/textile.exe
go-textile/textile-arm
android-textile/mobile
react-native-sdk/textile-androidx
react-native-sdk/textile-android

iOS

Because can not npm publish full 300MB package, so you have to install tools described below and

cd node_modules/textiot/
./build-mac.sh

results:

go-textile/textile-mac
go-textile/mobile/dist/ios/Mobile.framework/
go-textile/mobile/dist/ios/protos/

Add below (after pod 'Folly') into ios/Podfile

  pod 'Textile', :path => '../node_modules/textiot/ios-textile'
  pod 'TextileCore', :path => '../node_modules/textiot/go-textile/mobile/dist/ios'

cd ios
pod install

require('textiot/react-native-sdk').default;

web

npm install textiot --save

require('textiot/js-http-client').default;

Docs

textile

tour of Textile

Develop

Install tools

golang >= 1.14.15

go get golang.org/x/mobile/cmd/gomobile
export PATH=~/go/bin:$PATH
gomobile init

if unrecognized import path "golang.org/x/mobile/cmd/gomobile , then

mkdir -p ~/go
cd ~/go
mkdir -p src/github.com/golang
mkdir -p src/golang.org
cd src/golang.org
ln -s ../github.com/golang x
cd ~/go/src/github.com/golang
git clone https://github.com/golang/mobile
git clone https://github.com/golang/tools
git clone https://github.com/golang/mod
git clone https://github.com/golang/sys
git clone https://github.com/golang/xerrors
go get golang.org/x/mobile/cmd/gomobile
gomobile init

and also

export GO111MODULE=on
export GOPROXY=https://goproxy.io

android sdk

android ndk r20

nodejs <=10.15.3

With go-textile/release/@textile/js-types/dist/index.d.ts generated by ./node_modules/protobufjs/bin/pbts running in nodejs 12.13.0 , will cause error in npm run build of react-native-sdk .

protoc --version to match change com.google.protobuf:protobuf-java:3.6.1

on Linux

sudo apt install protobuf-compiler

on macOS

brew install protobuf

to install protoc, and

protoc --version

to get its version e.g. 3.12.4.

Then need change com.google.protobuf:protobuf-java:3.6.1 to com.google.protobuf:protobuf-java:3.12.4 in go-textile/release/PBProject/pb/build.gradle, otherwise will cause error: cannot find symbol UnusedPrivateParameter when ./gradlew pb:build in go-textile/release/PBProject/, just as sed in ./build-post-npm.sh.

Then need change com.google.protobuf:protobuf-java:3.6.1 to com.google.protobuf:protobuf-java:3.12.4 in android-textile/textile/build.gradle and android/build.gradle, just as sed in ./build-post-npm.sh, otherwise the APP will crash E AndroidRuntime: java.lang.NoSuchMethodError: No static method internalBuildGeneratedFileFrom([Ljava/lang/String;[Lcom/google/protobuf/Descriptors$FileDescriptor;)Lcom/google/protobuf/Descriptors$FileDescriptor; in class Lcom/google/protobuf/Descriptors$FileDescriptor; or its super classes when run into list.toByteArray() of final Model.ThreadList list in textiot/react-native-sdk/android/src/main/java/io/textile/rnmobile/ThreadsBridge.java.

All will be built by build.sh on Linux except mobile/dist/ios/protos and mobile/dist/ios/Mobile.framework/ by build-mac.sh on macOS. Similarly, if protoc --version return 3.13.0 on macOS, then need change s.dependency 'Protobuf', '~> 3.7' to s.dependency 'Protobuf', '3.13.0' in ios-textile/Textile.podspec and go-textile/mobile/dist/ios/TextileCore.podspec, just as sed in ./build-mac.sh.

protoc-gen-go 7e65e51

If you modify go-textile/pb/protos/*.proto, then you also need regenerate go-textile/pb/*.pb.go by an exact version of protoc-gen-go which match protoc 3.x (or protoc-gen-go@7e65e51 described below)

go get -d -u github.com/golang/protobuf/protoc-gen-go
cd ~/go/src/github.com/golang/protobuf/protoc-gen-go
git checkout 7e65e51
go build
mv protoc-gen-go ~/go/bin/

or just

go install github.com/golang/protobuf/protoc-gen-go@7e65e51

regenerate:

cd go-textile
make protos

google.golang.org/protobuf v1.26.1-0.20210525005349-febffdd88e85

There is exact 1.26-dev version

google.golang.org/protobuf v1.26.1-0.20210525005349-febffdd88e85

in go.mod, if miss it or even a bigger version e.g.

google.golang.org/protobuf v1.27.0

will cause panic: proto: file "message.proto" is already registered when run ./textile, ref to proto: file is already registered with different packages and reflect/protoregistry: restore conflicting file names check.

Maybe can use protoc-gen-go with the same version with go.mod, because the key to resolve the panic is should only about go.mod not about the protoc-gen-go, and I validate the result of protoc is same between protoc-gen-go@7e65e51 above and protoc-gen-go@febffdd below.

go install google.golang.org/protobuf/cmd/protoc-gen-go@febffdd

If can't install above for network reason, install below is also ok

cd ~/go/pkg/mod/google.golang.org/[email protected]/cmd/protoc-gen-go/
go build -o ~/go/bin

regenerate:

cd go-textile
make protos

suod apt install mingw-w64 gcc-arm-linux-gnueabihf

Xcode on macOS

Build on Linux

./build.sh

results:

go-textile/textile
go-textile/textile.exe
go-textile/textile-arm
android-textile/pb-androidx
android-textile/pb-android
android-textile/mobile
react-native-sdk/textile-androidx
react-native-sdk/textile-android
react-native-sdk/dist/index.js

Build on macOS

./build-mac.sh

results:

go-textile/textile-mac
go-textile/mobile/dist/ios/Mobile.framework/
go-textile/mobile/dist/ios/protos/

Build on macOS

./build-web.sh

results:

js-http-client/dist/index.js

Changelog

[email protected]

go-ipfs v0.8.0

And no ipfs repo migration from 0.4.22 to 0.8.0 support here, so you need migrate with ipfs official migration tool by yourself if you want.

[email protected]

go-ipfs v0.4.22-0.20191002225611-b15edf287df6