Giters

M1NuTeLaTe11 / Elastos.Trinity

Root repository for elastOS aka Trinity, dApps browser developed by the Elastos Foundation. Look for Elastos.Trinity.* for all submodules.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Elastos Trinity

Android & IOS Android(Windows)
Build Status Build status

Introduction

Elastos Trinity integrates all the services that Elastos provides and combines them into a singular framework for DApp developers to use. For this reason, DApp developers only need to write their application using ionic javascript framework and have only one set of Runtime APIs to manage.

Elastos Trinity is supported on both Android and iOS.

While Elastos Trinity is the project codename, this product is also known as the elastOS browser on traditional app stores.

Table of Contents

Roadmap

Q4 2019/Q1 2020 - "Focus on developers"

  • [COMPLETED] Advanced runtime concepts (inter app communications, elastos scheme, API permissions)
  • [COMPLETED] Wallet DApp phase 2 (Trinity as an SPV wallet) - payments requests support
  • [COMPLETED] DID DApp (Trinity as user identity management)
  • [COMPLETED] DPos Voting DApp
  • CR Voting DApps
  • RedPackets DApp
  • [COMPLETED] Temporary centralized DApp store
  • Ethereum smart contracts fully usable
  • [COMPLETED] DID plugin
  • [80%] Efficient tool chain (easy initial setup, package, debug, publish, easy switch between dev and prod env or mainnet and testnet)
  • [70%] Documentation
  • Automated testing
  • Frequent releases that can break existing DApps
  • Conversion from launcher style to browser style
  • elastOS on iOS
  • Blockchain explorer dApp
  • Wallet dApp UI/UX rework

Q2/Q3 2020 - "Focus on end users"

  • Versioning / Backward compatibility management (fewer releases, branches strategy)
  • Developers able to write production ready DApps
  • Releases based on stable sub-module releases
  • Great user experience for end users (great UI design, dynamic launcher, home screen widgets, notifications, animations, convenient menus, onboarding information, ELA purchases made easy…)
  • DApp store based on the DApp sidechain
  • Maintenance of everything existing
  • New features to be defined according to initial feedback from both developers and end users during previous phases
  • New features integrated according to the main Elastos product roadmap (ex: new sidechains)

Download Trinity for Android

stable version

latest version(tag starting with daily)

Checking out the source code

To clone the repository in your environment:

git clone --recurse-submodules git@github.com:elastos/Elastos.Trinity.git

We use --recurse-submodules here because we need to download the submodules as well. If you forgot to use the argument, you could download the submodules later by typing:

git submodule update --init --recursive

And then use git add, commit and push to submit your changes to current project.

To update the whole Trinity (main repo + submodules) to latest master commits, run this:

# Pull all submodules on latest master
./synccode.sh
./ToolChains/bin/build clean
./ToolChains/bin/build all

If you know what you are doing, you can also only build runtime, build plugin ..., etc.

How to build

Requirements

  • cordova
  • ionic
  • node
  • npm
  • python
For Android:
  • Java JDK 1.8 or greater
  • Android SDK
  • Android NDK (android-ndk-r16b or higher)

The supported way of doing this nowadays is to use Android Studio.

Set the ANDROID_HOME environment variable to match the Android SDK path.

on Mac and Linux, add the following line to your login script (e.g., ~/.bashrc, ~/.bash_profile, etc...):

export ANDROID_HOME="YOUR-PATH/sdk"

On Windows, set the environment variable in the control panel.

For iOS:
  • Xcode 10 or higher

Build on Ubuntu / Debian / Linux Host

cd YOUR-PATH/Elastos.Trinity
./ToolChains/bin/build all

Using Android Studio:

Open project from YOUR-PATH/Elastos.Trinity/Runtime/platforms/android

Build on MacOS Host

cd YOUR-PATH/Elastos.Trinity
./ToolChains/bin/build all

Using Android Studio:

Open project from YOUR-PATH/Elastos.Trinity/Runtime/platforms/android

Using Xcode:

Open project from YOUR-PATH/Elastos.Trinity/Runtime/platforms/ios

Build on Windows Host

cd YOUR-PATH/Elastos.Trinity
python ToolChains/bin/build all

Using Android Studio:

Open project from YOUR-PATH/Elastos.Trinity/Runtime/platforms/android

Build script options

  • build clean: deletes runtime platforms.

    if you update plugins, you should call build clean, then build runtime. Otherwise, latest plugins changes are not applied inside the native app.

  • build clobber: deletes all generated or downloaded files (everything).

  • build runtime: builds runtime module.

  • build launcher: builds launcher and runtime module.

  • build all: builds all modules, include runtime, launcher and dapps.

  • build plugin -p plugin_path: reinstalls the specified plugin.

NOTE：You can type ./ToolChains/bin/build --help for more details.

build all takes time, so it is advised to build the relevant target only.

Dapp developer should not use any of this and instead get the latest APK from app stores or github releases and follow the Elastos Developer Website Trinity guides.

Repositories

Elastos.Trinity is composite repository to Elastos Trinity infrastructure, which can be divided into the following submodules:

where category DApps includes several specific DApps repositories:

while category Plugins includes the following repostiories:

Contribution

We welcome contributions to the Elastos Trinity Project.

Acknowledgments

A sincere thank you to all teams and projects that we rely on directly or indirectly.

About

Root repository for elastOS aka Trinity, dApps browser developed by the Elastos Foundation. Look for Elastos.Trinity.* for all submodules.

Languages

Language:Shell 100.0%