Resource Qualifiers Documentation

Former Member over 10 years ago

Hello There,

Is there a place where valid resource qualifiers are listed. One of the things I find frustrating with the connect IQ documentation is that details like this are left out (or not put where you expect to find them). Looking at this page we are only really given examples of qualifiers, not a list of qualifiers that are valid. So for device specific I have been playing a guessing game to get it to work.

For example, it list for screen shape that there is round, semiround, rectangle, etc.. Does that mean that there is more than the first three? I am hoping that there is a way to specify "tall" devices as there is a tall watch simulator. I haven't had luck with resource-tall

Thank you for your time.

Braden

jim_m_58 over 10 years ago

I forget where I saw it (a doc or in a sample), but the "shapes" you see are generic. for example, "square" can be a va, a va-hr, or an edge and like an epix or 920 (they all have square corners!)

To refine that in your code you need to look at width and height.

But for resources, you use:

resources-vivoactive_hr
resources-vivoactive
resources-edge_520

etc and that gets you what you want....

There is no "resource-tall" in a real environment, as "tall" is generic, and was in place before Garmin announced the va-hr..... (same with "semi-round" for the fr 23x/630/735)

travis.vitek over 10 years ago

Is there a place where valid resource qualifiers are listed.

Yes. Open up ${SDKROOT}/bin/devices.xml and have a peek around. You'll see

<device_families>
        <device_family id="round" >
            <device_family id="218x218" />
        </device_family>
        <device_family id="semiround" >
            <device_family id="215x180" />
        </device_family>
        <device_family id="rectangle" >
            <device_family id="205x148" />
            <device_family id="148x205" />
            <device_family id="240x400" />
            <device_family id="200x265" />
        </device_family>
    </device_families>

So you can use resources, resources-round, resources-round-218x218, resources-semiround, ... If you look at the device element for the devices that follow, you'll see the family attribute, which specifies which exact family a device matches.

Travis