Documentation

Armory has been designed as a tool for managing big sophisticated projects with hundreds of classes and files on the board. The main aim of this tool is to reduce the cognitive load on the developer by reinventing some of the principal ways how workspace can be organized.

This document describes most basic functions of the Armory plugin and can be used as general guidlines for it.

Creating and Managing Tree Views

The Armory tool window lets you look at your project from various viewpoints and perform the tasks such as creating new items (directories, packages, files, classes, etc.), opening files in the editor, navigating to the code fragment of interest, and more.

The Armory tool window can contains one or more Tree Views inside. A new Tree View can be created by one of the following ways:

• By selecting menu item Add Tree View in the options menu.
• By dragging an element to the existing Tree View edge.
• By choosing menu item Add as Root to...  (Ctrl + Up shortcut) in the element context menu.

Reordering of the Tree Views is available by dragging in the Tree View title.

Managing Tree View Roots

Each Tree View can contain many Root Elements inside. There are several ways how to add a new Root Element to the Tree View:

• By dragging an element to the title area.
• By selecting Add as Root context menu item.
• From keyboard by pressing shortcut Ctrl + Up and selecting desirable Tree View

Removing Root Elements is available by dragging them to the title area.

Grouping Elements

Sometimes it is very useful to group certain elements by logic. If you don't want to create a separate class or package you can combine elements in a group. This does not affect the structure of the code, but visual perception of the class may become noticeably easier. 

Grouping is available for the following types of the elements:

• Files and folders
• Classes and interfaces
• Class members (methods, fields)

Ungrouping of the existing group is available by one of the following ways:

• By pressing Del key on the group
• By selecting Ungroup menu item in the context menu

Creating and Managing Sorting Schemes

The order of the elements in the Tree View is defined by the current sorting scheme. To change the order you need to select a preset option or to create a new sorting scheme. To toggle the collation sequence you can click either the toolbar button or the context menu item.

The illustration below shows how to change the sorting scheme through the toolbar button.

The following picture makes it clear how to select your preference via the context menu item of the tree.

To create new sorting schemes and to edit existing ones please go to the corresponding section of Armory Settings > Sorting Schemes. Here you can change the sorting order of the elements, add or remove elements involved in sorting, as well as add, delete, and rename sorting schemes themselves.

Armory Actions

Here is the complete list of the Armory actions with default shortcuts.

Editor actions

Tree actions

Element actions

Grouping actions

Root actions