HIC SUNT DRACONES
Note: Cartographer is a very early work in progress, so approach with caution. For the moment, development on Windows 10 and 11 is not supported.
Building and running Cartographer requires:
- macOS (for iOS and Android) or Linux (Android only)
- An iPhone or iPad running iOS 10+
- An Android device running 8+
If you haven't already, install React Native and it's dependencies.
git clone [email protected]:localhost-international/cartographer.git
cd cartographer
yarn
Now, make a copy of ./environments/.env.example.ts
to a new file named ./environments/.env..ts
.
- Create a new Etherscan API key
- Add the above as the key value of
ETHERSCAN_API_KEY
in the newly created.env.development.ts
- Add a wallet address as a 42 character base16 string or ENS name as the value of
ETH_WALLET_ADDRESS
Building React Native on iOS requires:
- macOS
- CocoaPods:
gem install cocoapods
- Ruby FFI (Foreign Function Interface):
gem install ffi
npx pod-install ios
npx react-native run-ios
yarn global add ios-deploy
npx react-native run-ios --device "Your Device Name"
When building with an M1 processor, use the following:
- Install CocoaPods with:
sudo arch -x86_64 gem install cocoapods
- Install ffi with:
sudo arch -x86_64 gem install ffi
- (Re-)install project dependencies:
arch -x86_64 pod install
Cartographer is currently in development and is being optimised for iOS/iPadOS.
Leave a comment on the Android Support issue so I know you're interested in an Android compatibility/release.
Building Cartographer for Android requires:
- macOS or Linux
- Android Studio 4.0+
- OpenJDK 8.
npx react-native run-android
Cartographer is currently only officially supported on Android and iOS, but can be built and run on the following platforms:
- macOS (via Catalyst)
- Windows 10 (UWP)
- Windows 11 (UWP or Android)