User Tools

Site Tools


manual:advanced:locus_api:information_about_locus

This is an old revision of the document!


Information about Locus

Most important for every extension - is Locus installed?

Starting point for similar questions are two classes

Basic tasks

Is Locus installed

Get list of available versions on your device

    LocusUtils.getAvailableVersions(Context ctx);

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

    LocusUtils.isLocusAvailable(Context ctx);

and check only true/false result.

Is Locus running

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

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

Advanced parameters

Where is Locus root directory

  1. obtain LocusInfo object (description in Is Locus running question)
  2. get absolute root path by LocusInfo.getRootDirectory()

Which units has user set in Locus

This method is very useful, for making units in your own app same as units in Locus. Advantage is that user do not have to set units on two different places.

  1. obtain LocusInfo object (description in Is Locus running question)
  2. get various units parameters by LocusInfo.getUnits…() functions

LocusInfo contains quite a lot of interesting information from life of Locus

manual/advanced/locus_api/information_about_locus.1432214653.txt.gz · Last modified: (external edit)