====== Information about Locus ======

The most important for every extension - //is Locus Map installed?//

__The starting point for similar questions are these two classes:__

  * [[https://bitbucket.org/asamm/locus-api-android/src/92c69dd50f58665c5bf72653099080995140e609/src/locus/api/android/utils/LocusUtils.java?at=default|LocusUtils]] - tools for work with versions
  * [[https://bitbucket.org/asamm/locus-api-android/src/92c69dd50f58665c5bf72653099080995140e609/src/locus/api/android/ActionTools.java?at=default|ActionTools]] - methods to get information from Locus itself

===== Basic tasks =====

==== Is Locus installed? ====

Get list of available versions on your device
<code java>
    LocusUtils.getAvailableVersions(Context ctx);
</code>

and check if result contains any //LocusVersion// objects.

Or if you don't care about //LocusVersion// (which is good to know, because this object is used later in many functions), you may use simple function

<code java>
    LocusUtils.isLocusAvailable(Context ctx);
</code>

and check only //true/false// result.

==== Is Locus running? ====

If you know //LocusVersion// you want to check, use following method

<code java>
    LocusInfo locusInfo = ActionTools.getLocusInfo(ctx, lv);
    if (locusInfo == null) {
        // problem with receiving information about Locus
        return false;
    } else {
        return locusInfo.isRunning();
    }
</code>