ecency-mobile/README.md

130 lines
5.1 KiB
Markdown
Raw Normal View History

2020-07-17 16:39:59 +03:00
### Ecency Mobile
2018-09-25 18:39:14 +03:00
2020-10-23 15:26:31 +03:00
iOS ![iOS](https://build.appcenter.ms/v0.1/apps/ef80aa2a-d4e1-4f43-a4f8-be12ea72ba9b/branches/master/badge)
Android ![Android](https://build.appcenter.ms/v0.1/apps/12aace32-b58a-49da-bf85-5477f89ae16e/branches/master/badge)
2019-03-27 01:56:11 +03:00
## Open Beta 🔥
2020-03-24 11:19:21 +03:00
2020-10-23 15:20:36 +03:00
[IOS](https://install.appcenter.ms/orgs/ecency/apps/ios/distribution_groups/beta_testers)
2019-03-27 01:56:11 +03:00
2020-10-23 15:20:36 +03:00
[ANDROID](https://install.appcenter.ms/orgs/ecency/apps/android/distribution_groups/beta_testers)
2019-03-27 01:56:11 +03:00
2020-03-24 11:19:21 +03:00
## Download
2020-07-17 16:39:59 +03:00
AppStore iOS: https://ios.ecency.com
PlayStore Android: https://android.ecency.com
2020-03-24 11:19:21 +03:00
2019-03-27 01:56:11 +03:00
### I. How do I get set up? 🔧
2018-09-25 18:39:14 +03:00
2020-07-17 17:43:12 +03:00
`$ git clone https://github.com/ecency/ecency-mobile.git`
2018-09-25 18:39:14 +03:00
2020-07-17 17:43:12 +03:00
`$ cd ecency-mobile`
2018-09-25 18:39:14 +03:00
2019-01-06 11:51:46 +03:00
`$ yarn`
2018-09-25 18:39:14 +03:00
`$ react-native start` (Now your local server should start)
2021-05-19 12:58:14 +03:00
## Setting up Reactotron
`Reactotron` for logging,
2021-05-19 12:58:14 +03:00
- Install: [download here](https://github.com/infinitered/reactotron/blob/master/docs/installing.md)
- Run: After installation, start the reactotron desktop application
- Link: For android, run `adb reverse tcp:9090 tcp:9090` and restart app. For iOS, it should connect without futher config.
- Usage:
1. use `Timeline` tab to track logs and network call
2. use `State` tab to track redux stage changes, to track particular store, add it by it's initilzing name, example: `account`
2021-05-19 12:58:14 +03:00
2018-09-25 18:39:14 +03:00
## Starting for IOS
2018-09-26 00:16:20 +03:00
2018-09-25 18:39:14 +03:00
### `react-native run-ios` (this also run `react-native start` if you didn't)
## Starting for Android
2018-09-26 00:16:20 +03:00
1. Create a new app in your firebase console.
2022-07-12 06:07:42 +03:00
2. Choose Add Android platform, with a package name of `app.esteem.mobile.android`
3. Download the generated `google-services.json` and place it in `<project-root>/android/app/`
4. Connect dev device or start android emulator.
5. Run `npm run android` in the project's root.
2018-09-25 18:39:14 +03:00
##### Using Android Studio's `adb`
1. Make sure that you can run adb from your terminal.
2. Open Genymotion and navigate to `Settings -> ADB`. Select “Use custom Android SDK tools” and update with your [Android SDK directory](https://stackoverflow.com/questions/25176594/android-sdk-location).
##### Using Genymotion's `adb`
1. Find Genymotions copy of adb. On macOS for example, this is normally `/Applications/Genymotion.app/Contents/MacOS/tools/`.
2. Add the Genymotion tools directory to your path (instructions for [Mac](http://osxdaily.com/2014/08/14/add-new-path-to-path-command-line/), [Linux](http://www.computerhope.com/issues/ch001647.htm), and [Windows](https://www.howtogeek.com/118594/how-to-edit-your-system-path-for-easy-command-line-access/)).
3. Make sure that you can run adb from your terminal.
2019-03-27 01:56:11 +03:00
# The Rules 🔪
2018-09-26 00:16:20 +03:00
### Patches and Review Process
#### Before you start
2018-09-25 18:39:14 +03:00
2019-01-03 16:38:51 +03:00
1. When you address an issue or a feature, make sure that there doesn't already exist a ISSUES ticket for this work item.
2018-09-25 18:39:14 +03:00
2020-07-17 17:43:12 +03:00
- [Issues](https://github.com/ecency/ecency-mobile/issues)
2018-09-26 00:16:20 +03:00
2. If the item already exists and is in progress, please remove the card or the issue you were assigned and leave a note that it is a duplicate.
3.If the item is not being worked on, please make sure that you put the card or issue as "In Progress" and assign it to yourself so other developers know that you are working on it.
#### Patch a day
2018-09-25 18:39:14 +03:00
It is important to make the work you are doing visible to other team members, especially because there are developers in different location.
Even if you are not done the work on your patch, make sure to put a Pull Request up and leave a note that this is work in progress (WIP) so that others do not try to merge in your patch.
If you would like to have someone in particular review your work, leave your patch as WIP and assign the developers that need to review or update your patch before it is ready to be reviewed by other team members.
2018-09-26 00:16:20 +03:00
#### Who to assign your patch for review
2019-03-27 01:56:11 +03:00
- [@feruzm](https://github.com/feruzm) 👮
- [@talhasch](https://github.com/talhasch) 🕵
- [@mistikk](https://github.com/mistikk) 👽
- [@ue](https://github.com/ue) 💀
2018-09-26 00:16:20 +03:00
### Patch Review Template
2018-09-25 18:39:14 +03:00
When you create a pull request for your patch, make sure to leave all the information that other team members will need to understand the purpose of your patch as well.
2018-09-26 00:16:20 +03:00
Main Branch `master`
2018-09-25 18:39:14 +03:00
If you resolved a issue or something You have to whern you commit your pr commit message include issue number for ex. resolved #10 or closed #10 etc.
2018-09-26 00:16:20 +03:00
#### Before you start
2018-09-25 18:39:14 +03:00
1. Pull every changes.
2. Switch your branch with development
3. Create about issues or bugfix branch.
4. Make sure your repo up to date!
2018-09-26 00:16:20 +03:00
#### Creating branch
2018-09-25 18:39:14 +03:00
- For example if you want create branch for an issue should contain issue number (ex. #55)
- Whats your interest put bugfix/your*branch_name or feature/your_branch_name*#issue_number
- If you some changes for only config req config/your_branch_name
2018-09-25 18:39:14 +03:00
2018-09-26 00:16:20 +03:00
#### Commit messages
2018-09-25 18:39:14 +03:00
2018-09-26 00:16:20 +03:00
What ever you want number of commit. Before create push squash your all commit. We need just what you do!
2018-09-25 18:39:14 +03:00
2018-09-26 00:16:20 +03:00
#### Pushing
2018-09-25 18:39:14 +03:00
- Make sure push your main branch (master)
2019-01-03 16:38:51 +03:00
2019-03-27 01:56:11 +03:00
# Issues 👻
2019-01-03 16:38:51 +03:00
To report a non-critical issue, please file an issue on this GitHub project.
2020-07-17 16:39:59 +03:00
If you find a security issue please report details to: security@ecency.com
2019-01-03 16:38:51 +03:00
We will evaluate the risk and make a patch available before filing the issue.
2019-06-25 18:30:15 +03:00
# Sponsors and Collaborators
2020-07-17 17:43:12 +03:00
- Hive community
2019-06-25 18:30:15 +03:00
- React native community
- Bugsnag
- Appcenter