mirror of
https://github.com/bitgapp/eqMac.git
synced 2024-11-26 16:05:52 +03:00
40 lines
1.9 KiB
Markdown
40 lines
1.9 KiB
Markdown
|
## Contribution
|
||
|
|
At the moment eqMac is going through a major rewrite and it's hard to coordinate the development of big features, but I'm open to try anyway. Please create an issue on GitHub (please check if your issue is already being discussed) or [join our Discord](https://discord.eqmac.app) to discuss. Once a piece of work has been agreed - fork, build, debug, fix, merge and create a Pull Request to get your work merged in :)
|
||
|
|
Check the documentation below to understand how to start eqMac debug process from Xcode
|
||
|
|
|
||
|
|
## Development
|
||
|
|
Fork the repository, then run these commands in Terminal.app:
|
||
|
|
|
||
|
|
```
|
||
|
|
git clone https://github.com/YOUR_USERNAME/eqMac.git
|
||
|
|
cd eqMac/
|
||
|
|
```
|
||
|
|
|
||
|
|
### Web User Interface
|
||
|
|
If you want to run the web based User Interface locally then you need to follow these steps to make that happen:
|
||
|
|
|
||
|
|
#### Prerequisites
|
||
|
|
Install [Node.js](https://nodejs.org/en/) LTS version preferrably using [NVM](https://github.com/nvm-sh/nvm#installing-and-updating)
|
||
|
|
|
||
|
|
#### Building and running the Web UI
|
||
|
|
1. Go into the ui/ directory by `cd ui/`
|
||
|
|
2. Install Node dependencies with `npm install`
|
||
|
|
3. Start local development server with `npm start`
|
||
|
|
|
||
|
|
### Native app + driver
|
||
|
|
#### Prerequisites
|
||
|
|
|
||
|
|
1. Download [Xcode](https://apps.apple.com/us/app/xcode/id497799835?mt=12)
|
||
|
|
2. Install [CocoaPods](https://cocoapods.org/) by `sudo gem install cocoapods`
|
||
|
|
3. Install [Carthage](https://github.com/Carthage/Carthage#installing-carthage) by `brew update && brew install carthage`
|
||
|
|
|
||
|
|
#### Building and running the App
|
||
|
|
|
||
|
|
1. Go into the native/app directory from root of the repo by: `cd native/app/`
|
||
|
|
2. Install Cocoapod dependencies: `pod install`
|
||
|
|
3. Install Carthage dependencies: `carthage update`
|
||
|
|
4. Go back to the native/ directory: `cd ../`
|
||
|
|
5. Open the Xcode workspace: `open eqMac.xcworkspace`
|
||
|
|
6. Launch eqMac in debug mode by running the **App - Debug** Scheme:
|
||
|
|
<img width="512" src="https://user-images.githubusercontent.com/8472525/83069640-279c1100-a062-11ea-85a7-45aa5253771b.png"/>
|