Skip to content

Latest commit

 

History

History
65 lines (47 loc) · 3.75 KB

setup.adoc

File metadata and controls

65 lines (47 loc) · 3.75 KB
Raw
Table of Contents

Setup

Prerequisites

We try to make it as simple as possible for you. However, there are some minimal prerequisites:

  • You need to have a tool to extract *.tar.gz files (tar and gzip). On Windows before Version 10 (1803) use 7-zip. On all other platforms this comes out of the box.

  • You need to have git.

    • On Windows you only need to download and install git for windows.

    • On Linux you might need to install the git in case it is not present (e.g. sudo apt-get install git or sudo yum install git-core)

    • On MacOS you only need to download and install git for mac.

Download

The latest release of IDEasy can be downloaded from here.

Install

Create a central folder projects folder (on Windows use C:\projects or D:\projects, on Linux or Mac use ~/projects but ensure your home path does not contain space or other special characters). Inside this folder, create a sub-folder named _ide and extract the contents of the downloaded archive (ide-cli-*.tar.gz) to this new folder (e.g. C:\projects\_ide). Run the command setup in this folder (on windows double clicking on setup.bat). To get started read the usage. After the installation process, you can create a new project by typing: ide create <project>, replace <project> with your project name. Switch to the project folder e.g. cd <project> and install or configure tools for your project as needed.

Note
 We are planning to create a installer that will guide users through the installation process but this is not yet released.

Uninstall

To "uninstall" your IDEasy you only need to call the following command:

ide uninstall

Then you can delete the projects folder if there is no project data left that you need.

IDEasy is designed to be non-invasive to your operating system and computer. Therefore it is not "installed" on your system in a classical way. Instead you just create a folder and extract the downloaded archive to it. All the other softwares remain locally in your IDEasy folder. However, there are the following excuses (what is reverted by ide uninstall):

  • The ide alias is added to your shell config (~/.bashrc and ~/.zshrc, search for: alias ide=).

  • The completion is added to your shell config (~/.bashrc and ~/.zshrc, search for: _ide/completion).

  • The IDE_ROOT environment variable is added to your environment variables.

  • The $IDE_ROOT/_ide/bin folder is added to your PATH environment variable.

  • IDEasy will download all third party software to your ~/Downloads/ide folder to reduce redundant storage. You have to delete this folder manually as we do not want to be responsible for data-loss in case users manually put files here.

Testing SNAPSHOT releases

Whenever a story in IDEasy is completed by merging a PR, our github actions will build a new SNAPSHOT release and on success deploy it to nexus on OSSRH. You can therefore find the latest IDEasy SNAPSHOT releases here. Simply choose the latest SNAPSHOT version folder and then inside the *.tar.gz file for the latest version. Once downloaded, you can proceed as with official releases (see install).

If you test the latest SNAPSHOT please also give feedback to bug or feature tickets to let us know if things are working or not. Thanks for your testing, support and help to make IDEasy better!