Views
AgileBrowser
(→Quick Guide) |
(→Quick Guide) |
||
| Line 54: | Line 54: | ||
[[File:kernel5.png]] | [[File:kernel5.png]] | ||
| + | |||
| + | From the graph it's now easy to see what kind of licenses elements have. LegendView (Center-East) shows the matching license based on coloring. Also it's possible to change color by clicking the color from the LegendView. | ||
| + | |||
| + | 6. Now if user wants to take a closer look at e.g. 'glibc' -element (this is in the graph), it is possible by double-clicking the element. This action shows the element with the same rules applied to it what we had done before. It shows the element with detail level 4 (this is because double-clicking drills down 1 level), it used automatically license coloring and it shows all the Outgoing dependencies. | ||
| + | |||
| + | [[File:kernel6.png]] | ||
== Full User Guide == | == Full User Guide == | ||
Revision as of 06:08, 24 May 2011
Download AgileBrowser installer
Contents |
Introduction
AgileBrowser is a free architecture management tool. It abstracts and visualizes software models of MeeGo OS. The main focus is to provide easier access to up-to-date architecture information gathered from multiple sources. The models contain stuctural and dependendency information. There are several types of external attributes to be attached to the information. Users of AgileBrowser can navigate, search, highlight with colors, share and export diagrams in various abstraction levels according to their individual needs.
Getting Started
Installation
Installer package is available in this wiki: File:AgileBrowser.zip
AgileBrowser can be run on Windows, Mac, Linux, etc., anywhere where Java is supported. The most important requirement is that the tool is memory expensive so it is recommended to have 1 GB RAM or fast swapping.
User Guide
There are different guides available. Quick guide is for basic use cases of Agile Browser. In Quick Guide user is introduced to basic functionalities via simple example. Full User Guide contains all the functionalities of the tool.
Quick Guide
It is time to take a closer look what AgileBrowser can do. This guide is a follow-up example, where user is introduced to AgileBrowser basic functions via a simple example.
1. Open a model file. Here meego_handset_armv7hl_n900_devel_1_2_deps.txt model is used. Model can be opened from the Model Repository tree (South-West corner) if models exists there or it can be opened from the locally using 'File' -> 'Open Model File'.
2. Then lets take a look what kind of kernel information model holds. Type 'kernel' into search field (text field located in North) and hit enter. This searches the model looking for the elements that have 'kernel' in name. In this case the result where given in the root level because we didn't gave any further details.
3. Now lets increase the Detail Level to get more detailed view about the 'kernel' search. Increase 'Detail Level' by 2 (Change 'Detail level 1' to 3 in Properties panel located in the North-East). This action adds two more detail levels to graph.
Browser now shows a good graph about Kernel in chosen model.
4. Lets now take a look at, that what elements/components are using these elements visible in the graph. So we are interested on what are the incoming dependencies. Select 'incoming' from the Dependencies combobox (located in the same Properties panel than the Detail level).
It automatically draws all the incoming dependencies to kernel search elements.
Then lets take a look what outgoing dependencies kernel search has. (change 'incoming' to 'outgoing' in Dependencies combobox.
5. Select an element from the graph to get more information about it (model has to contain attributes to get attribute information). If element has some attributes, those are shown in the Info panel (located in the South-East). In this case we selected 'kernel-headers'. Attribute information shows that kernel-headers is under GPLv2 license.
Now we are interested that what kind of licenses does the elements in the graph have. Lets change the coloring to be based on licensing information. Select 'Coloring' to be 'license under the 'Attribute Highlighting' (from the Properties panel again).
This action colors all the elements that have license information. So same licenses are with the same color and so on. This is a good way to get a big picture about some attribute information, in this case about license.
From the graph it's now easy to see what kind of licenses elements have. LegendView (Center-East) shows the matching license based on coloring. Also it's possible to change color by clicking the color from the LegendView.
6. Now if user wants to take a closer look at e.g. 'glibc' -element (this is in the graph), it is possible by double-clicking the element. This action shows the element with the same rules applied to it what we had done before. It shows the element with detail level 4 (this is because double-clicking drills down 1 level), it used automatically license coloring and it shows all the Outgoing dependencies.
