# Rocket.Chat.Electron **Repository Path**: xiezhongtian/Rocket.Chat.Electron ## Basic Information - **Project Name**: Rocket.Chat.Electron - **Description**: No description available - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2021-01-11 - **Last Updated**: 2021-01-13 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Rocket.Chat Desktop App [![Travis CI Build Status](https://img.shields.io/travis/RocketChat/Rocket.Chat.Electron/master.svg?logo=travis)](https://travis-ci.org/RocketChat/Rocket.Chat.Electron) [![AppVeyor Build Status](https://img.shields.io/appveyor/ci/RocketChat/rocket-chat-electron/master.svg?logo=appveyor)](https://ci.appveyor.com/project/RocketChat/rocket-chat-electron) [![Codacy Badge](https://api.codacy.com/project/badge/Grade/3a87141c0a4442809d9a2bff455e3102)](https://www.codacy.com/app/tassoevan/Rocket.Chat.Electron?utm_source=github.com&utm_medium=referral&utm_content=RocketChat/Rocket.Chat.Electron&utm_campaign=Badge_Grade) [![Project Dependencies](https://david-dm.org/RocketChat/Rocket.Chat.Electron.svg)](https://david-dm.org/RocketChat/Rocket.Chat.Electron) [![GitHub All Releases](https://img.shields.io/github/downloads/RocketChat/Rocket.Chat.Electron/total.svg)](https://github.com/RocketChat/Rocket.Chat.Electron/releases/latest) ![GitHub](https://img.shields.io/github/license/RocketChat/Rocket.Chat.Electron.svg) Desktop application for [Rocket.Chat][] available for macOS, Windows and Linux using [Electron][]. ![Rocket.Chat Desktop App](https://user-images.githubusercontent.com/2263066/91490997-c0bd0c80-e889-11ea-92c7-2cbcc3aabc98.png) --- ## Engage with us ### Share your story We’d love to hear about [your experience][] and potentially feature it on our [Blog][]. ### Subscribe for Updates Once a month our marketing team releases an email update with news about product releases, company related topics, events and use cases. [Sign Up!][] --- ## Download You can download the latest version from the [Releases][] page. [![Get it from the Snap Store](https://snapcraft.io/static/images/badges/en/snap-store-black.svg)](https://snapcraft.io/rocketchat-desktop) ## Install Launch the installer and follow the instructions to install. ### Windows Options On Windows you can run a silent install by adding the `/S` flag. You can also add the options below: - `/S` - Silent install - `/allusers` - Install for all users (requires admin) - `/currentuser` - Install only the for current user (default) - `/disableAutoUpdates` - Disable automatic updates ## Development ### Quick start Prerequisites: - [Git](http://git-scm.com/book/en/v2/Getting-Started-Installing-Git) - [Node.js](https://nodejs.org) - [node-gyp](https://github.com/nodejs/node-gyp#installation) - [Yarn](http://yarnpkg.com/) is recommended instead of npm. Now just clone and start the app: ```sh git clone https://github.com/RocketChat/Rocket.Chat.Electron.git cd Rocket.Chat.Electron yarn yarn start ``` ### Structure of the project The source is located in the `src` folder. Everything in this folder will be built automatically when running the app with `yarn start`. The build process compiles all stuff from the `src` folder and puts it into the `app` folder, so after the build has finished, your `app` folder contains the full, runnable application. ### TypeScript Following the [ongoing changes in Rocket.Chat codebase][], the app was rewritten in TypeScript 4 to address issues regarding maintainability. ### The build pipeline The build process is founded upon [rollup][] bundler. There are three entry files for your code: - `src/main.ts`, the script running at the main Electron process, orchestrating the whole application; - `src/rootWindow.ts`, the script that renders the UI of the *root window*, the app's main window; - and `src/preload.ts`, which runs in a privileged mode to connect the app and the webviews rendering Rocket.Chat's web client. #### Adding Node.js modules Remember to respect the split between `dependencies` and `devDependencies` in `package.json` file. Only modules listed in `dependencies` will be included into distributable app. ### Troubleshooting #### node-gyp Follow the installation instruction on [node-gyp readme][]. #### Ubuntu You will need to install the following packages: ```sh build-essential libevas-dev libxss-dev ``` #### Fedora You will need to install the following packages: ```sh libX11 libXScrnSaver-devel gcc-c++ ``` #### Windows 7 On Windows 7 you may have to follow option 2 of the [node-gyp install guide] and install Visual Studio. ### Testing #### Unit tests ```sh yarn test ``` We use [Jest][] testing framwork with the [Jest electron runner][]. It searches for all files in `src` directory that match the glob pattern `*.(spec|test).{js,ts,tsx}`. ### Making a release To package your app into an installer use command: ```sh yarn release ``` It will start the packaging process for operating system you are running this command on. Ready for distribution file will be outputted to `dist` directory. All packaging actions are handled by [electron-builder][]. It has a lot of [customization options][]. ## Default servers The `servers.json` file will define what servers the client will connect to and will populate the server list in the sidebar. It contains a list of default servers which will be added the first time the user runs the app (or when all servers are removed from the list). The file syntax is as follows: ```json { "Demo Rocket Chat": "https://demo.rocket.chat", "Open Rocket Chat": "https://open.rocket.chat" } ``` ### Pre-Release Configuration You can bundle a `servers.json` with the install package, the file should be located in the root of the project application (same level as the `package.json`). If the file is found, the initial "Connect to server" screen will be skipped and it will attempt to connect to the first server in the array that has been defined and drop the user right at the login screen. Note that the `servers.json` will only be checked if no other servers have already been added, even if you uninstall the app without removing older preferences, it will not be triggered again. ### Post-Install Configuration If you can't (or don't want to) bundle the file inside the app, you can create a `servers.json` in the user preferences folder which will overwrite the packaged one. The file should be located in the `%APPDATA%/Rocket.Chat/` folder or the installation folder in case of a installation for all users (Windows only). For Windows, the full paths are: - `~\Users\\AppData\Roaming\Rocket.Chat\` - `~\Program Files\Rocket.Chat\Resources\` On macOS, the full paths are: - `~/Users//Library/Application Support/Rocket.Chat/` - `~/Applications/Rocket.Chat.app/Contents/Resources/` On Linux, the full paths are: - `/home//.config/Rocket.Chat/` - `/opt/Rocket.Chat/resources/` ## License Released under the MIT license. [Rocket.Chat]: https://rocket.chat [Electron]: https://electronjs.org/ [your experience]: https://survey.zohopublic.com/zs/e4BUFG [Blog]: https://rocket.chat/case-studies/?utm_source=github&utm_medium=readme&utm_campaign=community [Sign Up!]: https://rocket.chat/newsletter/?utm_source=github&utm_medium=readme&utm_campaign=community [Releases]: https://github.com/RocketChat/Rocket.Chat.Electron/releases/latest [ongoing changes in Rocket.Chat codebase]: https://forums.rocket.chat/t/moving-away-from-meteor-and-beyond/3270 [rollup]: https://github.com/rollup/rollup [node-gyp readme]: https://github.com/nodejs/node-gyp#installation [Jest]: https://jestjs.io/ [Jest electron runner]: https://github.com/facebook-atom/jest-electron-runner [electron-builder]: https://github.com/electron-userland/electron-builder [customization options]: https://github.com/electron-userland/electron-builder/wiki/Options [node-gyp install guide]: https://github.com/nodejs/node-gyp#installation