|
1 | | -# RoboticsAcademy-Desktop |
| 1 | +<a href="https://jderobot.github.io/"><img src="./resources/logo.gif" width="150" align="right" /></a> |
2 | 2 |
|
3 | | -## Table of Contents |
| 3 | +# RoboticsAcademy Desktop: Learn Robotics, Artificial Intelligence and Computer Vision |
| 4 | + |
| 5 | +### Table of Contents |
4 | 6 |
|
5 | 7 | - [About](#about) |
6 | | -- [Getting Started](#getting-started) |
7 | | -- [Usage](#usage) |
| 8 | +- [Installation](#installation) |
| 9 | +- [Development](#development) |
| 10 | +- [Build](#build) |
| 11 | +- [Contributing](#build) |
8 | 12 |
|
9 | 13 | ## About |
10 | 14 |
|
11 | | -TThe Robotics-Academy Desktop Application is an application used for accessing the Robotics-Academy exercises on any platform, This has been built using Electron.js. |
| 15 | +The Robotics-Academy Desktop Application is an application used for accessing the Robotics-Academy exercises on any platform, This has been built using Electron.js. |
| 16 | +JdeRobot Academy is an open source platform that provides a collection of exercises for learning robotics in a practical way. RoboticsAcademy is completely ROS-based, and includes robotics standard tools like Gazebo and Rviz. |
| 17 | + |
| 18 | +## Installation |
| 19 | + |
| 20 | +### Prerequisites |
12 | 21 |
|
13 | | -## Getting Started |
| 22 | +- [Node.js](https://nodejs.org/en) |
| 23 | +- [npm](https://www.npmjs.com/) |
14 | 24 |
|
15 | | -TO BUILD AND USE THE APP USE THE FOLLOWING INSTRUCTIONS |
| 25 | +### Steps |
16 | 26 |
|
17 | | -Install the packages using : |
| 27 | +1. Clone the repository: |
18 | 28 |
|
19 | | -```console |
20 | | -npm install |
| 29 | +``` |
| 30 | +git clone https://github.com/JdeRobot/RoboticsAcademy-Desktop.git |
| 31 | +cd RoboticsAcademy-Desktop |
21 | 32 | ``` |
22 | 33 |
|
23 | | -Build the electron App using : |
| 34 | +2. Install dependencies |
24 | 35 |
|
25 | | -```console |
26 | | -npm run make |
| 36 | +``` |
| 37 | +npm install |
| 38 | +``` |
| 39 | + |
| 40 | +3. Run the application |
| 41 | + |
| 42 | +``` |
| 43 | +npm run start |
27 | 44 | ``` |
28 | 45 |
|
29 | | -After building a **out** folder will be created. Copy the **run.sh** from the **Script** folder and paste it into **out/electron** |
| 46 | +### Development |
30 | 47 |
|
31 | | -Download and Paste the **Robotics-Academy tar.xz** into **out/electron/roboticsacademy** |
| 48 | +#### Getting Started |
32 | 49 |
|
33 | | -## Usage |
| 50 | +To start developing, follow the installation steps above, and then run the app in development mode: |
34 | 51 |
|
35 | | -To run the App do the following |
| 52 | +1. Start the app in development mode: |
36 | 53 |
|
37 | 54 | ``` |
38 | | -cd out/electron... |
39 | | -cd script |
40 | | -chmod +x run.sh |
41 | | -./run.sh |
| 55 | +npm run dev |
42 | 56 | ``` |
| 57 | + |
| 58 | +### Build |
| 59 | + |
| 60 | +- Linux (Ubuntu): |
| 61 | + After successfully installing the dependencies. Run the |
| 62 | + |
| 63 | + ``` |
| 64 | + npm run build:linux |
| 65 | + ``` |
| 66 | + |
| 67 | +#### Build Package: |
| 68 | + |
| 69 | +:round_pushpin: After successfully executing the build command, the target build package will be found in the :file_folder: **dist** folder. |
| 70 | + |
| 71 | +:warning: You may need to install build dependencies for target package. [Learn more](https://www.electronjs.org/docs/latest/development/build-instructions-linux) |
| 72 | + |
| 73 | +:black_nib: You can configure builder as your need. See [electron-builder.yml](./electron-builder.yml) file. |
| 74 | + |
| 75 | +### Contributing |
| 76 | + |
| 77 | +Take a look at the [contributing](./CONTRIBUTING.md) guide lines. |
0 commit comments