Prerequisite
Emulator manager and Virtual remote has been developed and tested on below environment
Visual Studio Code is a source-code editor made by Microsoft for Windows, Linux and macOS.
Electron (formerly known as Atom Shell) is a free and open-source software framework developed and maintained by GitHub. It allows for the development of desktop GUI applications using web technologies: it combines the Chromium rendering engine and the Node. js runtime.
- Google Chrome: Version 96.0.4664.93 (Official Build) (64-bit)
Google Chrome is a cross-platform web browser developed by Google.
Node.js is an open-source, cross-platform, back-end JavaScript runtime environment that runs on the V8 engine and executes JavaScript code outside a web browser.
- V8: 9.1.269.39-electron.0
V8 is Google's open source high-performance JavaScript and WebAssembly engine, written in C++. It is used in Chrome and in Node.js, among others.
- OS: Linux x64 5.11.0-41-generic
An operating system is system software that manages computer hardware, software resources, and provides common services for computer programs.
Run application
Follow below steps to run application on host pc and create installer package
- step 1 - get the emulator src code (link will be added soon) then run below command
$ npm install
- step 2 - run below command
$ npm run start
Create installer package
Follow below steps to create installer package for linux/windows/mac
- Once code is ready. please run below commands to make deb file for linux intaller.
$ npm install electron-packager
$ electron-packager . --platform linux --arch x64 --out dist --overwrite
$ electron-installer-debian --src dist/EMV-linux-x64/ --arch amd64 --config config.json
- Installer package will be created and stored inside the dist folder.
For the complete documentation on electronjs refer link: https://www.electronjs.org/.
Features
VM Manager
- Install image: By clicking on install image button user/developer can install the available image into the vm.
- Show installed OS List: By clicking on the show installed os list button user/developer can see the list of installed images into the vm.
- Start VM: By clicking on start vm button user/developer can start the vm.
- Shutdown VM: By clicking on shutdown vm button user/developer can power off the vm.
- Reboot VM: By clicking on reboot vm button user/developer can restart/reboot the vm.
App Manager
- Configure emulator ip address: User has to configure the emulator ip address, after ip configuration user will be able to send commands to applications running on emulator.
- Set app url: User/developer having the option to set the application url which is running on host machine and on clicking launch button app will be launched on emulator.
- launch ResidentApp: By clicking on launch residentapp button default residentapp will be launched.
- Automate tests option: By clicking on automate tests button developer will get the option to upload files in json/xml format and execute the test scripts. user will be able to see the results.
- Launch IDE: By clicking on launch ide button developer can launch the pre-configured vs code and do modification in the code after that need to run $ lng dev command and immediately changes will reflect on emulator.
Api Manager
- Validate Api: Developer can use this option to validate the plugin api's, just need to provide the required parameters to be passed and on clicking on validate api button below results will be printed. Developer can refer given plugin api lists in Api manager.
Remote Manager
- Launch remote: User/developer can choose the remote from the available remotes listed in remote manager and on clicking use this button selected remote will be launched on window.