New Developer FAQ

Brandon.ConnectIQ — Mon, 03 Mar 2025 15:52:03 GMT

Current Revision posted to Wiki by Brandon.ConnectIQ on 3/3/2025 3:52:03 PM

Where can I download the SDK?
How do I get started with Connect IQ?
I just downloaded the latest SDK. Can I build apps that will work on any device that supports Connect IQ?
Am I allowed to charge for my app though the Connect IQ app store?
Can I display seconds on my watch face?
How do I format output padded with leading zeros?
How can I load the apps I develop to my device for testing purposes?
I have side-loaded an app as described above, but app settings won't work. Why is this?
My app uses app settings, and it sometimes crashes after changing the settings, but the rest of the time it works fine. What can cause this?
I keep getting a "Too Many Arguments Error", but I never used to get this. What is going on?
How can I test or debug Connect IQ apps I am developing?
I think that I've found a bug with CIQ. How do I report it?

Where can I download the SDK?

The latest version of the SDK can be found at http://developer.garmin.com/connect-iq/sdk/.

How do I get started with Connect IQ?

The Connect IQ Basics Guide is a good place to start gaining familiarity with Monkey C and Connect IQ.
Once you're set up, take a look at the Core Topics and User Experience Guide for more in-depth info.
API Documentation and more Monkey C specifics are also available on our developer site.
The SDK includes a set of sample apps in the 'samples' folder that demonstrate some of the basic capabilities of Connect IQ.

If you have questions along the way, these forums are the best place to go for assistance. Many questions have already been answered in previously posted threads, however both the Connect IQ team and several experienced developers monitor the forums to answer new questions or respond to issues you may encounter.

I just downloaded the latest SDK. Can I build apps that will work on any device that supports Connect IQ?

Yes! We have designed the SDK so that you can target any Connect IQ-compatible devices, regardless of the Connect IQ version they support. A project can be configured to target a minimum SDK version, which limits the selectable target devices to those that support the selected Connect IQ version. Targeting the newest version of Connect IQ will limit the devices that can run your app, but will give you access to all of the latest goodies. Anything built targeting earlier SDK versions will work on the latest devices, so allows your app to run on more devices as long as you don't need the newest features for your app.

The minimum SDK selector is designed to build for the highest supported SDK for each device. For example, consider this set of devices: device A (3.x), B (2.x), and C (1.x). The table below illustrates how the build system is designed to function:

Minimum SDK Selected	Eligible Target Devices	What Gets Built
3.0.x	A	3.0.x PRG for A
2.4.x	A, B	3.0.x PRG for A, 2.4.x PRG for B
1.2.x	A, B, C	3.0.x PRG for A, 2.4.x PRG for B, 1.2.x PRG for C

Am I allowed to charge for my app though the Connect IQ app store?

Yes, you are! Garmin offers a monetization solution that allows you to accept payments for your apps directly through the App Store. You can read more about it in the Monetization docs.

It is also acceptable to list prices, link to payment sites, or ask for donations on the Connect IQ app store as long as solicitations are related to your app and you mark that the app requires payments, etc., in the app listing details.. The app store falls under the the Connect IQ SDK License Agreement, which does not forbid solicitation for sales of apps by app developers. However, solicitation for business on Garmin sites other than the app store (such as this forum) is prohibited but Garmin's Terms of Use.

Can I display seconds on my watch face?

Yes, you can! However, one priority of Connect IQ is the preservation of battery life, so we have a system in place that governs how often watch faces may be updated. Generally, watch faces update once per minute in low power mode, and once per second when in full power mode. The watch will enter full power mode for a few seconds when the user gestures to look at it, and then returns to low power mode. Developers will often detect this transition to full power mode, display a seconds indicator for a few moments, and then hide the seconds indicator once the device returns to low power mode. Newer devices may also support Always On watch faces, which can update once per second as long as they operate within certain limits.

You can find out more about low power mode, full power mode, and Always On watch faces in the Connect IQ Basics Guide, or read about the related APIs in the API Docs.

How do I format output padded with leading zeros?

Many Connect IQ apps include time values that require leading zeros. For example, time written in an HH:MM:SS format appears as "12:05:05" rather than "12:5:5". Monkey C includes string formatting functions that can get this job done using a %02d format specifier.

A common error is to specify a format of %.2d or %0.2d. This may pad a decimal with leading zeros in some languages, such as in C++'s printf() function, but Monkey C follows the C99 standard. C99 requires the 0 flag to specify padding with leading zeros for d, i, o, u, x, X, a, A, e, f, F, g, and G conversions. In addition, C99 states that if a precision is specified with '.', the the 0 flag is ignored.

How can I load the apps I develop to my device for testing purposes?

Apps are typically installed to devices via the Connect IQ App Store, but it's often useful to side-load an app to a device for testing without having to first upload a version to the app store. Here's how (this assumes you already have the Monkey C Visual Studio Code Extension installed):

In Visual Studio Code, choose View > Command Palette...
Select Monkey C: Build for Device
Select the target product from the device list
Choose an output location for the build
Select either Debug or Release depending on your intent (either will build a PRG that will run on a device)
Connect your device to the computer via USB (it should appear as a drive)
Copy the PRG file from the output location to /GARMIN/APPS on your device
Disconnect your device; the app should be available for use

I have side-loaded an app as described above, but app settings won't work. Why is this?

App settings allow user to configure an app via the Connect IQ Store app, Garmin Express, or Garmin Connect Mobile, and depend on the Connect IQ App Store to function properly. When an app is side loaded, this connection to the Connect IQ App Store is never established. If you have an app that uses app settings that needs to be tested, you may submit the app to the Connect IQ App Store and test out the settings features while the app is either in a beta state or pending approval.

My app uses app settings, and it sometimes crashes after changing the settings, but the rest of the time it works fine. What can cause this?

In the past, there have been issues where the client used to manage app settings, like the Connect IQ Store app, Garmin Express, or Garmin Connect Mobile, has returned a setting value with an unexpected type, so it's good practice to check a setting value to ensure it's the expected type. For example, this code will check for a null value and convert the value to a Number as long as it is not null. Otherwise, a default value is returned:

function readKeyInt(myApp,key,thisDefault) {
    var value = myApp.getProperty(key);
    if(value == null || !(value instanceof Number)) {
        if(value != null) {
            value = value.toNumber();
        } else {
            value = thisDefault;
        }
    }
    return value;
}

I keep getting a "Too Many Arguments Error", but I never used to get this. What is going on?

We added a a feature in the 2.1.2 SDK release to perform an argument count check on function and method calls. This was included as part of a larger security effort, which includes things like app signing and encryption of app data. Overall, this is a good thing, since it promotes more robust source code prevents some potential security exploits. Unfortunately, it has also caused some apps to crash on 1.3.x and 2.x devices when built with the 2.1.2 SDK even though these same apps execute without issue when built with earlier SDK releases. This kind of crash appears in the CIQ_LOG.TXT or CIQ_LOG.YML file as a Too many arguments error, signifying the argument count check has failed. Here are a couple of examples that illustrate potential causes:

Missing state arguments for the onStart() and onStop() methods. These are currently unused arguments and were passed implicitly in earlier versions of Connect IQ, but must now be included explicitly.
An initialize() method that takes an array of options but to which none are passed.

How can I test or debug Connect IQ apps I am developing?

A simple way to test Connect IQ apps is to include System.println() statements at strategic points in your app. Within Eclipse, these statements will output to the console. On a device, these statements write to the /GARMIN/APPS/LOGS<APPNAME>.TXT file, if it exists. This file is not automatically created, so must be created manually and named to match the name of the app's PRG file. For example, to log output from /GARMIN/APPS/MYAPP.PRG, create the /GARMIN/APPS/LOGS/MYAPP.TXT file.

For more advanced debugging, Connect IQ has a unit testing framework called Run No Evil, and a debugger that's included in the Connect IQ plug-in for Eclipse that can be used to dig into potential issues within the Connect IQ simulator. Check out the Debugging and Unit Testing chapters of the Core Topics Guide for more info.

In addition to these tools, there are two general types of on-device crash that can occur related to Connect IQ, which each generate log files: app crashes and device crashes.

App crashes typically result in an app quitting unexpectedly or displaying an 'IQ!' icon, but does not cause the entire device to crash or reboot. This kind of crash is most commonly due to a bug in an app, though it can also be due to a bug in Connect IQ itself. Whenever an app crash occurs, a /GARMIN/APPS/LOGS/CIQ_LOG.YML file is written to the device, which usually contains a call stack from the app (older devices may write a CIQ_LOG.TXT file).

Device crashes typically cause the device to reboot or freeze. These indicate a Connect IQ or device firmware bug, and should be much less common than app crashes. When a device crash occurs, an ERR_LOG.TXT file is typically written to /GARMIN or /GARMIN/DEBUG on the device, containing stack trace information related to the crash. Garmin's device teams can take a look at the device crash logs to determine the cause of the crash and will typically provide a fix in a future firmware release.

When any crash log file exceeds 5 KB, it will automatically be archived to <LOGNAME>.BAK, and a new log will be started. Any old .BAK files will be overwritten when the archive occurs, so the maximum practical space available for logging is ~10 KB.

I think that I've found a bug with CIQ. How do I report it?

If you think you've found a Connect IQ bug, please report it in the Connect IQ Bug Reports tool! Please make sure to read the Bug Reporting FAQ to ensure you provide us with the information we need to investigate the problem. Be advised that if you post about a bug in the discussion forum, your thread may be moved or deleted.

Tags: Getting Started, New Developer, CIQ, Connect IQ, New

New Developer FAQ

Brandon.ConnectIQ — Mon, 03 Mar 2025 15:50:15 GMT

Revision 20 posted to Wiki by Brandon.ConnectIQ on 3/3/2025 3:50:15 PM

Where can I download the SDK?
How do I get started with Connect IQ?
I just downloaded the latest SDK. Can I build apps that will work on any device that supports Connect IQ?
Am I allowed to charge for my app though the Connect IQ app store?
Can I display seconds on my watch face?
How do I format output padded with leading zeros?
How can I load the apps I develop to my device for testing purposes?
I have side-loaded an app as described above, but app settings won't work. Why is this?
My app uses app settings, and it sometimes crashes after changing the settings, but the rest of the time it works fine. What can cause this?
I keep getting a "Too Many Arguments Error", but I never used to get this. What is going on?
How can I test or debug Connect IQ apps I am developing?
I think that I've found a bug with CIQ. How do I report it?
My app is receiving inappropriate reviews. Is there something I can do about that?

Where can I download the SDK?

The latest version of the SDK can be found at http://developer.garmin.com/connect-iq/sdk/.

How do I get started with Connect IQ?

The Connect IQ Basics Guide is a good place to start gaining familiarity with Monkey C and Connect IQ.
Once you're set up, take a look at the Core Topics and User Experience Guide for more in-depth info.
API Documentation and more Monkey C specifics are also available on our developer site.
The SDK includes a set of sample apps in the 'samples' folder that demonstrate some of the basic capabilities of Connect IQ.

I just downloaded the latest SDK. Can I build apps that will work on any device that supports Connect IQ?

Minimum SDK Selected	Eligible Target Devices	What Gets Built
3.0.x	A	3.0.x PRG for A
2.4.x	A, B	3.0.x PRG for A, 2.4.x PRG for B
1.2.x	A, B, C	3.0.x PRG for A, 2.4.x PRG for B, 1.2.x PRG for C

Am I allowed to charge for my app though the Connect IQ app store?

Can I display seconds on my watch face?

You can find out more about low power mode, full power mode, and Always On watch faces in the Connect IQ Basics Guide, or read about the related APIs in the API Docs.

How do I format output padded with leading zeros?

How can I load the apps I develop to my device for testing purposes?

In Visual Studio Code, choose View > Command Palette...
Select Monkey C: Build for Device
Select the target product from the device list
Choose an output location for the build
Select either Debug or Release depending on your intent (either will build a PRG that will run on a device)
Connect your device to the computer via USB (it should appear as a drive)
Copy the PRG file from the output location to /GARMIN/APPS on your device
Disconnect your device; the app should be available for use

I have side-loaded an app as described above, but app settings won't work. Why is this?

function readKeyInt(myApp,key,thisDefault) {
    var value = myApp.getProperty(key);
    if(value == null || !(value instanceof Number)) {
        if(value != null) {
            value = value.toNumber();
        } else {
            value = thisDefault;
        }
    }
    return value;
}

I keep getting a "Too Many Arguments Error", but I never used to get this. What is going on?

Missing state arguments for the onStart() and onStop() methods. These are currently unused arguments and were passed implicitly in earlier versions of Connect IQ, but must now be included explicitly.
An initialize() method that takes an array of options but to which none are passed.

How can I test or debug Connect IQ apps I am developing?

In addition to these tools, there are two general types of on-device crash that can occur related to Connect IQ, which each generate log files: app crashes and device crashes.

My app is receiving inappropriate reviews. Is there something I can do about that?

Developers may flag reviews of their own apps they believe are inappropriate and provide a reason explaining why. Store admins will evaluate each case and remove reviews that violate Garmin's Terms of Use (see https://www.garmin.com/en-US/legal/terms-of-use/).

Tags: Getting Started, New Developer, CIQ, Connect IQ, New

New Developer FAQ

Brandon.ConnectIQ — Mon, 03 Mar 2025 15:33:33 GMT

Revision 19 posted to Wiki by Brandon.ConnectIQ on 3/3/2025 3:33:33 PM

Where can I download the SDK?
How do I get started with Connect IQ?
I just downloaded the latest SDK. Can I build apps that will work on any device that supports Connect IQ?
Am I allowed to charge for my app though the Connect IQ app store?
Can I display seconds on my watch face?
How do I format output padded with leading zeros?
How can I load the apps I develop to my device for testing purposes?
I have side-loaded an app as described above, but app settings won't work. Why is this?
My app uses app settings, and it sometimes crashes after changing the settings, but the rest of the time it works fine. What can cause this?
I keep getting a "Too Many Arguments Error", but I never used to get this. What is going on?
How can I test or debug Connect IQ apps I am developing?
I think that I've found a bug with CIQ. How do I report it?
My app is receiving inappropriate reviews. Is there something I can do about that?

Where can I download the SDK?

The latest version of the SDK can be found at http://developer.garmin.com/connect-iq/sdk/.

How do I get started with Connect IQ?

The Connect IQ Basics Guide is a good place to start gaining familiarity with Monkey C and Connect IQ.
Once you're set up, take a look at the Core Topics and User Experience Guide for more in-depth info.
API Documentation and more Monkey C specifics are also available on our developer site.
The SDK includes a set of sample apps in the 'samples' folder that demonstrate some of the basic capabilities of Connect IQ.

I just downloaded the latest SDK. Can I build apps that will work on any device that supports Connect IQ?

Minimum SDK Selected	Eligible Target Devices	What Gets Built
3.0.x	A	3.0.x PRG for A
2.4.x	A, B	3.0.x PRG for A, 2.4.x PRG for B
1.2.x	A, B, C	3.0.x PRG for A, 2.4.x PRG for B, 1.2.x PRG for C

Am I allowed to charge for my app though the Connect IQ app store?

Can I display seconds on my watch face?

You can find out more about low power mode, full power mode, and Always On watch faces in the Connect IQ Basics Guide, or read about the related APIs in the API Docs.

How do I format output padded with leading zeros?

How can I load the apps I develop to my device for testing purposes?

In Eclipse, choose Connect IQ > Build for Device Wizard…
In the Build for Device Wizard window:
- Choose the project you wish to build
- Choose the target device
- Choose the SDK version to target
- Specify a signing key
- Set an output location
- Click Finish
Connect your device to the computer via USB (it should appear as a drive)
Copy the PRG file made by the Build for Device Wizard from the output location to /GARMIN/APPS on your device
Disconnect your device; the app should be available for use

I have side-loaded an app as described above, but app settings won't work. Why is this?

function readKeyInt(myApp,key,thisDefault) {
    var value = myApp.getProperty(key);
    if(value == null || !(value instanceof Number)) {
        if(value != null) {
            value = value.toNumber();
        } else {
            value = thisDefault;
        }
    }
    return value;
}

I keep getting a "Too Many Arguments Error", but I never used to get this. What is going on?

Missing state arguments for the onStart() and onStop() methods. These are currently unused arguments and were passed implicitly in earlier versions of Connect IQ, but must now be included explicitly.
An initialize() method that takes an array of options but to which none are passed.

How can I test or debug Connect IQ apps I am developing?

In addition to these tools, there are two general types of on-device crash that can occur related to Connect IQ, which each generate log files: app crashes and device crashes.

My app is receiving inappropriate reviews. Is there something I can do about that?

Tags: Getting Started, New Developer, CIQ, Connect IQ, New

New Developer FAQ

Brandon.ConnectIQ — Tue, 16 Apr 2024 21:51:16 GMT

Revision 18 posted to Wiki by Brandon.ConnectIQ on 4/16/2024 9:51:16 PM

Where can I download the SDK?
How do I get started with Connect IQ?
I just downloaded the latest SDK. Can I build apps that will work on any device that supports Connect IQ?
Am I allowed to charge for my app though the Connect IQ app store?
Can I display seconds on my watch face?
How do I format output padded with leading zeros?
How can I load the apps I develop to my device for testing purposes?
I have side-loaded an app as described above, but app settings won't work. Why is this?
My app uses app settings, and it sometimes crashes after changing the settings, but the rest of the time it works fine. What can cause this?
I keep getting a "Too Many Arguments Error", but I never used to get this. What is going on?
How can I test or debug Connect IQ apps I am developing?
I think that I've found a bug with CIQ. How do I report it?
My app is receiving inappropriate reviews. Is there something I can do about that?

Where can I download the SDK?

The latest version of the SDK can be found at http://developer.garmin.com/connect-iq/sdk/.

How do I get started with Connect IQ?

The Connect IQ Basics Guide is a good place to start gaining familiarity with Monkey C and Connect IQ.
Once you're set up, take a look at the Core Topics and User Experience Guide for more in-depth info.
API Documentation and more Monkey C specifics are also available on our developer site.
The SDK includes a set of sample apps in the 'samples' folder that demonstrate some of the basic capabilities of Connect IQ.

I just downloaded the latest SDK. Can I build apps that will work on any device that supports Connect IQ?

Minimum SDK Selected	Eligible Target Devices	What Gets Built
3.0.x	A	3.0.x PRG for A
2.4.x	A, B	3.0.x PRG for A, 2.4.x PRG for B
1.2.x	A, B, C	3.0.x PRG for A, 2.4.x PRG for B, 1.2.x PRG for C

Am I allowed to charge for my app though the Connect IQ app store?

Yes, you are! It is acceptable to list prices, link to payment sites, or ask for donations on the Connect IQ app store as long as solicitations are related to your app. The app store falls under the the Connect IQ SDK License Agreement, which does not forbid solicitation for sales of apps by app developers. However, solicitation for business on Garmin sites other than the app store (such as this forum) is prohibited but Garmin's Terms of Use.

Can I display seconds on my watch face?

You can find out more about low power mode, full power mode, and Always On watch faces in the Connect IQ Basics Guide, or read about the related APIs in the API Docs.

How do I format output padded with leading zeros?

How can I load the apps I develop to my device for testing purposes?

In Eclipse, choose Connect IQ > Build for Device Wizard…
In the Build for Device Wizard window:
- Choose the project you wish to build
- Choose the target device
- Choose the SDK version to target
- Specify a signing key
- Set an output location
- Click Finish
Connect your device to the computer via USB (it should appear as a drive)
Copy the PRG file made by the Build for Device Wizard from the output location to /GARMIN/APPS on your device
Disconnect your device; the app should be available for use

I have side-loaded an app as described above, but app settings won't work. Why is this?

function readKeyInt(myApp,key,thisDefault) {
    var value = myApp.getProperty(key);
    if(value == null || !(value instanceof Number)) {
        if(value != null) {
            value = value.toNumber();
        } else {
            value = thisDefault;
        }
    }
    return value;
}

I keep getting a "Too Many Arguments Error", but I never used to get this. What is going on?

Missing state arguments for the onStart() and onStop() methods. These are currently unused arguments and were passed implicitly in earlier versions of Connect IQ, but must now be included explicitly.
An initialize() method that takes an array of options but to which none are passed.

How can I test or debug Connect IQ apps I am developing?

In addition to these tools, there are two general types of on-device crash that can occur related to Connect IQ, which each generate log files: app crashes and device crashes.

My app is receiving inappropriate reviews. Is there something I can do about that?

Tags: Getting Started, New Developer, CIQ, Connect IQ, New

New Developer FAQ

Brandon.ConnectIQ — Tue, 05 Jan 2021 20:25:47 GMT

Revision 17 posted to Wiki by Brandon.ConnectIQ on 1/5/2021 8:25:47 PM

Where can I download the SDK?
How do I get started with Connect IQ?
I just downloaded the latest SDK. Can I build apps that will work on any device that supports Connect IQ?
Am I allowed to charge for my app though the Connect IQ app store?
Can I display seconds on my watch face?
How do I format output padded with leading zeros?
How can I load the apps I develop to my device for testing purposes?
I have side-loaded an app as described above, but app settings won't work. Why is this?
My app uses app settings, and it sometimes crashes after changing the settings, but the rest of the time it works fine. What can cause this?
I keep getting a "Too Many Arguments Error", but I never used to get this. What is going on?
How can I test or debug Connect IQ apps I am developing?
I think that I've found a bug with CIQ. How do I report it?
My app is receiving inappropriate reviews. Is there something I can do about that?

Where can I download the SDK?

The latest version of the SDK can be found at http://developer.garmin.com/connect-iq/sdk/.

How do I get started with Connect IQ?

The Connect IQ Basics Guide is a good place to start gaining familiarity with Monkey C and Connect IQ.
Once you're set up, take a look at the Core Topics and User Experience Guide for more in-depth info.
API Documentation and more Monkey C specifics are also available on our developer site.
The SDK includes a set of sample apps in the 'samples' folder that demonstrate some of the basic capabilities of Connect IQ.

I just downloaded the latest SDK. Can I build apps that will work on any device that supports Connect IQ?

Minimum SDK Selected	Eligible Target Devices	What Gets Built
3.0.x	A	3.0.x PRG for A
2.4.x	A, B	3.0.x PRG for A, 2.4.x PRG for B
1.2.x	A, B, C	3.0.x PRG for A, 2.4.x PRG for B, 1.2.x PRG for C

Am I allowed to charge for my app though the Connect IQ app store?

Can I display seconds on my watch face?

You can find out more about low power mode, full power mode, and Always On watch faces in the Connect IQ Basics Guide, or read about the related APIs in the API Docs.

How do I format output padded with leading zeros?

How can I load the apps I develop to my device for testing purposes?

In Eclipse, choose Connect IQ > Build for Device Wizard…
In the Build for Device Wizard window:
- Choose the project you wish to build
- Choose the target device
- Choose the SDK version to target
- Specify a signing key
- Set an output location
- Click Finish
Connect your device to the computer via USB (it should appear as a drive)
Copy the PRG file made by the Build for Device Wizard from the output location to /GARMIN/APPS on your device
Disconnect your device; the app should be available for use

I have side-loaded an app as described above, but app settings won't work. Why is this?

function readKeyInt(myApp,key,thisDefault) {
    var value = myApp.getProperty(key);
    if(value == null || !(value instanceof Number)) {
        if(value != null) {
            value = value.toNumber();
        } else {
            value = thisDefault;
        }
    }
    return value;
}

I keep getting a "Too Many Arguments Error", but I never used to get this. What is going on?

Missing state arguments for the onStart() and onStop() methods. These are currently unused arguments and were passed implicitly in earlier versions of Connect IQ, but must now be included explicitly.
An initialize() method that takes an array of options but to which none are passed.

How can I test or debug Connect IQ apps I am developing?

In addition to these tools, there are two general types of on-device crash that can occur related to Connect IQ, which each generate log files: app crashes and device crashes.

My app is receiving inappropriate reviews. Is there something I can do about that?

Developers may flag reviews of their own apps they believe are inappropriate and provide a reason explaining why. Store admins will evaluate each case and remove reviews that:

Contain abusive language or profanity
Are not relevant to the app or are spam
Reference a firmware bug and not an app bug (since that's not the app developer's fault)
Refer to a device support issue (e.g. I don't know how to configure my activity with this data field)

Tags: Getting Started, New Developer, CIQ, Connect IQ, New

New Developer FAQ

Brandon.ConnectIQ — Tue, 05 Jan 2021 19:55:16 GMT

Revision 16 posted to Wiki by Brandon.ConnectIQ on 1/5/2021 7:55:16 PM

Where can I download the SDK?
How do I get started with Connect IQ?
I just downloaded the latest SDK. Can I build apps that will work on any device that supports Connect IQ?
Am I allowed to charge for my app though the Connect IQ app store?
Can I display seconds on my watch face?
How do I format output padded with leading zeros?
How can I load the apps I develop to my device for testing purposes?
I have side-loaded an app as described above, but app settings won't work. Why is this?
My app uses app settings, and it sometimes crashes after changing the settings, but the rest of the time it works fine. What can cause this?
I keep getting a "Too Many Arguments Error", but I never used to get this. What is going on?
How can I test or debug Connect IQ apps I am developing?
I think that I've found a bug with CIQ. How do I report it?
My app is receiving inappropriate reviews. Is there something I can do about that?

Where can I download the SDK?

The latest version of the SDK can be found at http://developer.garmin.com/connect-iq/sdk/.

How do I get started with Connect IQ?

The Connect IQ Basics Guide is a good place to start gaining familiarity with Monkey C and Connect IQ.
Once you're set up, take a look at the Core Topics and User Experience Guide for more in-depth info.
API Documentation and more Monkey C specifics are also available on our developer site.
The SDK includes a set of sample apps in the 'samples' folder that demonstrate some of the basic capabilities of Connect IQ.

I just downloaded the latest SDK. Can I build apps that will work on any device that supports Connect IQ?

Minimum SDK Selected	Eligible Target Devices	What Gets Built
3.0.x	A	3.0.x PRG for A
2.4.x	A, B	3.0.x PRG for A, 2.4.x PRG for B
1.2.x	A, B, C	3.0.x PRG for A, 2.4.x PRG for B, 1.2.x PRG for C

Am I allowed to charge for my app though the Connect IQ app store?

Can I display seconds on my watch face?

You can find out more about low power mode, full power mode, and Always On watch faces in the Programmer's Guide and User Experience Guide, or read about the related APIs in the API Docs.

How do I format output padded with leading zeros?

How can I load the apps I develop to my device for testing purposes?

In Eclipse, choose Connect IQ > Build for Device Wizard…
In the Build for Device Wizard window:
- Choose the project you wish to build
- Choose the target device
- Choose the SDK version to target
- Specify a signing key
- Set an output location
- Click Finish
Connect your device to the computer via USB (it should appear as a drive)
Copy the PRG file made by the Build for Device Wizard from the output location to /GARMIN/APPS on your device
Disconnect your device; the app should be available for use

I have side-loaded an app as described above, but app settings won't work. Why is this?

App settings allow user to configure an app via Garmin Express or Garmin Connect Mobile, and depend on the Connect IQ App Store to function properly. When an app is side loaded, this connection to the Connect IQ App Store is never established. If you have an app that uses app settings that needs to be tested, you may submit the app to the Connect IQ App Store and test out the settings features while the app is either in a beta state or pending approval.

My app uses app settings, and it sometimes crashes after changing the settings, but the rest of the time it works fine. What can cause this?

In the past, there have been issues where the client used to manage app settings, like Garmin Express or Garmin Connect Mobile, has returned a setting value with an unexpected type, so it's good practice to check a setting value to ensure it's the expected type. For example, this code will check for a null value and convert the value to a Number as long as it is not null. Otherwise, a default value is returned:

function readKeyInt(myApp,key,thisDefault) {
    var value = myApp.getProperty(key);
    if(value == null || !(value instanceof Number)) {
        if(value != null) {
            value = value.toNumber();
        } else {
            value = thisDefault;
        }
    }
    return value;
}

I keep getting a "Too Many Arguments Error", but I never used to get this. What is going on?

Missing state arguments for the onStart() and onStop() methods. These are currently unused arguments and were passed implicitly in earlier versions of Connect IQ, but must now be included explicitly.
An initialize() method that takes an array of options but to which none are passed.

How can I test or debug Connect IQ apps I am developing?

For more advanced debugging, Connect IQ has a unit testing framework called Run No Evil, and a debugger that's included in the Connect IQ plug-in for Eclipse that can be used to dig into potential issues within the Connect IQ simulator. Check out the How to Test chapter of the Programmer's Guide for more info.

In addition to these tools, there are two general types of on-device crash that can occur related to Connect IQ, which each generate log files: app crashes and device crashes.

I think that I've found a bug with CIQ. How do I report it?

If you think you've found a Connect IQ bug, please report it in the Connect IQ Bug Reports tool! Please make sure to read the Bug Reporting Rules to ensure you provide us with the information we need to investigate the problem. Be advised that if you post about a bug in the discussion forum, your thread may be moved or deleted.

My app is receiving inappropriate reviews. Is there something I can do about that?

Developers may flag reviews of their own apps they believe are inappropriate and provide a reason explaining why. Store admins will evaluate each case and remove reviews that:

Contain abusive language or profanity
Are not relevant to the app or are spam
Reference a firmware bug and not an app bug (since that's not the app developer's fault)
Refer to a device support issue (e.g. I don't know how to configure my activity with this data field)

Tags: Getting Started, New Developer, CIQ, Connect IQ, New

New Developer FAQ

Brandon.ConnectIQ — Fri, 20 Dec 2019 15:59:43 GMT

Revision 15 posted to Wiki by Brandon.ConnectIQ on 12/20/2019 3:59:43 PM

Where can I download the SDK?
How do I get started with Connect IQ?
I just downloaded the latest SDK. Can I build apps that will work on any device that supports Connect IQ?
Am I allowed to charge for my app though the Connect IQ app store?
Can I display seconds on my watch face?
How do I format output padded with leading zeros?
How can I load the apps I develop to my device for testing purposes?
I have side-loaded an app as described above, but app settings won't work. Why is this?
My app uses app settings, and it sometimes crashes after changing the settings, but the rest of the time it works fine. What can cause this?
I keep getting a "Too Many Arguments Error", but I never used to get this. What is going on?
How can I test or debug Connect IQ apps I am developing?
I think that I've found a bug with CIQ. How do I report it?
My app is receiving inappropriate reviews. Is there something I can do about that?

Where can I download the SDK?

The latest version of the SDK can be found at http://developer.garmin.com/connect-iq/sdk/.

How do I get started with Connect IQ?

The Programmer's Guide and User Experience Guide are good places to start gaining familiarity with Monkey C and Connect IQ.
API Documentation is available on our developer site.
The SDK also includes a set of sample apps in the 'samples' folder that demonstrate the capabilities of Connect IQ.

I just downloaded the latest SDK. Can I build apps that will work on any device that supports Connect IQ?

Minimum SDK Selected	Eligible Target Devices	What Gets Built
3.0.x	A	3.0.x PRG for A
2.4.x	A, B	3.0.x PRG for A, 2.4.x PRG for B
1.2.x	A, B, C	3.0.x PRG for A, 2.4.x PRG for B, 1.2.x PRG for C

Am I allowed to charge for my app though the Connect IQ app store?

Can I display seconds on my watch face?

You can find out more about low power mode, full power mode, and Always On watch faces in the Programmer's Guide and User Experience Guide, or read about the related APIs in the API Docs.

How do I format output padded with leading zeros?

How can I load the apps I develop to my device for testing purposes?

In Eclipse, choose Connect IQ > Build for Device Wizard…
In the Build for Device Wizard window:
- Choose the project you wish to build
- Choose the target device
- Choose the SDK version to target
- Specify a signing key
- Set an output location
- Click Finish
Connect your device to the computer via USB (it should appear as a drive)
Copy the PRG file made by the Build for Device Wizard from the output location to /GARMIN/APPS on your device
Disconnect your device; the app should be available for use

I have side-loaded an app as described above, but app settings won't work. Why is this?

My app uses app settings, and it sometimes crashes after changing the settings, but the rest of the time it works fine. What can cause this?

In the past, there have been issues where the client used to manage app settings, like Garmin Express or Garmin Connect Mobile, has returned a setting value with an unexpected type, so it's good practice to check a setting value to ensure it's the expected type. For example, this code will check for a null value and convert the value to a Number as long as it is not null. Otherwise, a default value is returned:

function readKeyInt(myApp,key,thisDefault) {
    var value = myApp.getProperty(key);
    if(value == null || !(value instanceof Number)) {
        if(value != null) {
            value = value.toNumber();
        } else {
            value = thisDefault;
        }
    }
    return value;
}

I keep getting a "Too Many Arguments Error", but I never used to get this. What is going on?

Missing state arguments for the onStart() and onStop() methods. These are currently unused arguments and were passed implicitly in earlier versions of Connect IQ, but must now be included explicitly.
An initialize() method that takes an array of options but to which none are passed.

How can I test or debug Connect IQ apps I am developing?

For more advanced debugging, Connect IQ has a unit testing framework called Run No Evil, and a debugger that's included in the Connect IQ plug-in for Eclipse that can be used to dig into potential issues within the Connect IQ simulator. Check out the How to Test chapter of the Programmer's Guide for more info.

In addition to these tools, there are two general types of on-device crash that can occur related to Connect IQ, which each generate log files: app crashes and device crashes.

I think that I've found a bug with CIQ. How do I report it?

If you think you've found a Connect IQ bug, please report it in the Connect IQ Bug Reports tool! Please make sure to read the Bug Reporting Rules to ensure you provide us with the information we need to investigate the problem. Be advised that if you post about a bug in the discussion forum, your thread may be moved or deleted.

My app is receiving inappropriate reviews. Is there something I can do about that?

Developers may flag reviews of their own apps they believe are inappropriate and provide a reason explaining why. Store admins will evaluate each case and remove reviews that:

Contain abusive language or profanity
Are not relevant to the app or are spam
Reference a firmware bug and not an app bug (since that's not the app developer's fault)
Refer to a device support issue (e.g. I don't know how to configure my activity with this data field)

Tags: Getting Started, New Developer, CIQ, Connect IQ, New

New Developer FAQ

Brandon.ConnectIQ — Fri, 20 Dec 2019 15:59:23 GMT

Revision 14 posted to Wiki by Brandon.ConnectIQ on 12/20/2019 3:59:23 PM

Where can I download the SDK?
How do I get started with Connect IQ?
I just downloaded the latest SDK. Can I build apps that will work on any device that supports Connect IQ?
Am I allowed to charge for my app though the Connect IQ app store?
Can I display seconds on my watch face?
How do I format output padded with leading zeros?
How can I load the apps I develop to my device for testing purposes?
I have side-loaded an app as described above, but app settings won't work. Why is this?
My app uses app settings, and it sometimes crashes after changing the settings, but the rest of the time it works fine. What can cause this?
I keep getting a "Too Many Arguments Error", but I never used to get this. What is going on?
How can I test or debug Connect IQ apps I am developing?
I think that I've found a bug with CIQ. How do I report it?
My app is receiving unfair or inappropriate reviews. Is there something I can do about that?

Where can I download the SDK?

The latest version of the SDK can be found at http://developer.garmin.com/connect-iq/sdk/.

How do I get started with Connect IQ?

The Programmer's Guide and User Experience Guide are good places to start gaining familiarity with Monkey C and Connect IQ.
API Documentation is available on our developer site.
The SDK also includes a set of sample apps in the 'samples' folder that demonstrate the capabilities of Connect IQ.

I just downloaded the latest SDK. Can I build apps that will work on any device that supports Connect IQ?

Minimum SDK Selected	Eligible Target Devices	What Gets Built
3.0.x	A	3.0.x PRG for A
2.4.x	A, B	3.0.x PRG for A, 2.4.x PRG for B
1.2.x	A, B, C	3.0.x PRG for A, 2.4.x PRG for B, 1.2.x PRG for C

Am I allowed to charge for my app though the Connect IQ app store?

Can I display seconds on my watch face?

You can find out more about low power mode, full power mode, and Always On watch faces in the Programmer's Guide and User Experience Guide, or read about the related APIs in the API Docs.

How do I format output padded with leading zeros?

How can I load the apps I develop to my device for testing purposes?

In Eclipse, choose Connect IQ > Build for Device Wizard…
In the Build for Device Wizard window:
- Choose the project you wish to build
- Choose the target device
- Choose the SDK version to target
- Specify a signing key
- Set an output location
- Click Finish
Connect your device to the computer via USB (it should appear as a drive)
Copy the PRG file made by the Build for Device Wizard from the output location to /GARMIN/APPS on your device
Disconnect your device; the app should be available for use

I have side-loaded an app as described above, but app settings won't work. Why is this?

My app uses app settings, and it sometimes crashes after changing the settings, but the rest of the time it works fine. What can cause this?

In the past, there have been issues where the client used to manage app settings, like Garmin Express or Garmin Connect Mobile, has returned a setting value with an unexpected type, so it's good practice to check a setting value to ensure it's the expected type. For example, this code will check for a null value and convert the value to a Number as long as it is not null. Otherwise, a default value is returned:

function readKeyInt(myApp,key,thisDefault) {
    var value = myApp.getProperty(key);
    if(value == null || !(value instanceof Number)) {
        if(value != null) {
            value = value.toNumber();
        } else {
            value = thisDefault;
        }
    }
    return value;
}

I keep getting a "Too Many Arguments Error", but I never used to get this. What is going on?

Missing state arguments for the onStart() and onStop() methods. These are currently unused arguments and were passed implicitly in earlier versions of Connect IQ, but must now be included explicitly.
An initialize() method that takes an array of options but to which none are passed.

How can I test or debug Connect IQ apps I am developing?

For more advanced debugging, Connect IQ has a unit testing framework called Run No Evil, and a debugger that's included in the Connect IQ plug-in for Eclipse that can be used to dig into potential issues within the Connect IQ simulator. Check out the How to Test chapter of the Programmer's Guide for more info.

In addition to these tools, there are two general types of on-device crash that can occur related to Connect IQ, which each generate log files: app crashes and device crashes.

I think that I've found a bug with CIQ. How do I report it?

If you think you've found a Connect IQ bug, please report it in the Connect IQ Bug Reports tool! Please make sure to read the Bug Reporting Rules to ensure you provide us with the information we need to investigate the problem. Be advised that if you post about a bug in the discussion forum, your thread may be moved or deleted.

My app is receiving inappropriate reviews. Is there something I can do about that?

Developers may flag reviews of their own apps they believe are inappropriate and provide a reason explaining why. Store admins will evaluate each case and remove reviews that:

Contain abusive language or profanity
Are not relevant to the app or are spam
Reference a firmware bug and not an app bug (since that's not the app developer's fault)
Refer to a device support issue (e.g. I don't know how to configure my activity with this data field)

Tags: Getting Started, New Developer, CIQ, Connect IQ, New

New Developer FAQ

Brandon.ConnectIQ — Thu, 04 Apr 2019 13:20:29 GMT

Revision 13 posted to Wiki by Brandon.ConnectIQ on 4/4/2019 1:20:29 PM

Where can I download the SDK?
How do I get started with Connect IQ?
I just downloaded the latest SDK. Can I build apps that will work on any device that supports Connect IQ?
Am I allowed to charge for my app though the Connect IQ app store?
Can I display seconds on my watch face?
How do I format output padded with leading zeros?
How can I load the apps I develop to my device for testing purposes?
I have side-loaded an app as described above, but app settings won't work. Why is this?
My app uses app settings, and it sometimes crashes after changing the settings, but the rest of the time it works fine. What can cause this?
I keep getting a "Too Many Arguments Error", but I never used to get this. What is going on?
How can I test or debug Connect IQ apps I am developing?
I think that I've found a bug with CIQ. How do I report it?

Where can I download the SDK?

The latest version of the SDK can be found at http://developer.garmin.com/connect-iq/sdk/.

How do I get started with Connect IQ?

The Programmer's Guide and User Experience Guide are good places to start gaining familiarity with Monkey C and Connect IQ.
API Documentation is available on our developer site.
The SDK also includes a set of sample apps in the 'samples' folder that demonstrate the capabilities of Connect IQ.

I just downloaded the latest SDK. Can I build apps that will work on any device that supports Connect IQ?

Minimum SDK Selected	Eligible Target Devices	What Gets Built
3.0.x	A	3.0.x PRG for A
2.4.x	A, B	3.0.x PRG for A, 2.4.x PRG for B
1.2.x	A, B, C	3.0.x PRG for A, 2.4.x PRG for B, 1.2.x PRG for C

Am I allowed to charge for my app though the Connect IQ app store?

Can I display seconds on my watch face?

You can find out more about low power mode, full power mode, and Always On watch faces in the Programmer's Guide and User Experience Guide, or read about the related APIs in the API Docs.

How do I format output padded with leading zeros?

How can I load the apps I develop to my device for testing purposes?

In Eclipse, choose Connect IQ > Build for Device Wizard…
In the Build for Device Wizard window:
- Choose the project you wish to build
- Choose the target device
- Choose the SDK version to target
- Specify a signing key
- Set an output location
- Click Finish
Connect your device to the computer via USB (it should appear as a drive)
Copy the PRG file made by the Build for Device Wizard from the output location to /GARMIN/APPS on your device
Disconnect your device; the app should be available for use

I have side-loaded an app as described above, but app settings won't work. Why is this?

My app uses app settings, and it sometimes crashes after changing the settings, but the rest of the time it works fine. What can cause this?

In the past, there have been issues where the client used to manage app settings, like Garmin Express or Garmin Connect Mobile, has returned a setting value with an unexpected type, so it's good practice to check a setting value to ensure it's the expected type. For example, this code will check for a null value and convert the value to a Number as long as it is not null. Otherwise, a default value is returned:

function readKeyInt(myApp,key,thisDefault) {
    var value = myApp.getProperty(key);
    if(value == null || !(value instanceof Number)) {
        if(value != null) {
            value = value.toNumber();
        } else {
            value = thisDefault;
        }
    }
    return value;
}

I keep getting a "Too Many Arguments Error", but I never used to get this. What is going on?

Missing state arguments for the onStart() and onStop() methods. These are currently unused arguments and were passed implicitly in earlier versions of Connect IQ, but must now be included explicitly.
An initialize() method that takes an array of options but to which none are passed.

How can I test or debug Connect IQ apps I am developing?

For more advanced debugging, Connect IQ has a unit testing framework called Run No Evil, and a debugger that's included in the Connect IQ plug-in for Eclipse that can be used to dig into potential issues within the Connect IQ simulator. Check out the How to Test chapter of the Programmer's Guide for more info.

In addition to these tools, there are two general types of on-device crash that can occur related to Connect IQ, which each generate log files: app crashes and device crashes.

I think that I've found a bug with CIQ. How do I report it?

If you think you've found a Connect IQ bug, please report it in the Connect IQ Bug Reports tool! Please make sure to read the Bug Reporting Rules to ensure you provide us with the information we need to investigate the problem. Be advised that if you post about a bug in the discussion forum, your thread may be moved or deleted.

Tags: Getting Started, New Developer, CIQ, Connect IQ, New

New Developer FAQ

Brandon.ConnectIQ — Wed, 03 Apr 2019 22:04:55 GMT

Revision 12 posted to Wiki by Brandon.ConnectIQ on 4/3/2019 10:04:55 PM

Where can I download the SDK?
How do I get started with Connect IQ?
I just downloaded the latest SDK. Can I build apps that will work on any device that supports Connect IQ?
Am I allowed to charge for my app though the Connect IQ app store?
Can I display seconds on my watch face?
How do I format output padded with leading zeros?
How can I load the apps I develop to my device for testing purposes?
I have side-loaded an app as described above, but app settings won't work. Why is this?
My app uses app settings, and it sometimes crashes after changing the settings, but the rest of the time it works fine. What can cause this?
I keep getting a "Too Many Arguments Error", but I never used to get this. What is going on?
How can I test or debug Connect IQ apps I am developing?
I think that I've found a bug with CIQ. How do I report it?

Where can I download the SDK?

The latest version of the SDK can be found at http://developer.garmin.com/connect-iq/sdk/.

How do I get started with Connect IQ?

The Programmer's Guide and User Experience Guide are good places to start gaining familiarity with Monkey C and Connect IQ.
API Documentation is available on our developer site.
The SDK also includes a set of sample apps in the 'samples' folder that demonstrate the capabilities of Connect IQ.

I just downloaded the latest SDK. Can I build apps that will work on any device that supports Connect IQ?

Minimum SDK Selected	Eligible Target Devices	What Gets Built
3.0.x	A	3.0.x PRG for A
2.4.x	A, B	3.0.x PRG for A, 2.4.x PRG for B
1.2.x	A, B, C	3.0.x PRG for A, 2.4.x PRG for B, 1.2.x PRG for C

Am I allowed to charge for my app though the Connect IQ app store?

Can I display seconds on my watch face?

You can find out more about low power mode, full power mode, and Always On watch faces in the Programmer's Guide and User Experience Guide, or read about the related APIs in the API Docs.

How do I format output padded with leading zeros?

How can I load the apps I develop to my device for testing purposes?

In Eclipse, choose Connect IQ > Build for Device Wizard…
In the Build for Device Wizard window:
- Choose the project you wish to build
- Choose the target device
- Choose the SDK version to target
- Specify a signing key
- Set an output location
- Click Finish
Connect your device to the computer via USB (it should appear as a drive)
Copy the PRG file made by the Build for Device Wizard from the output location to /GARMIN/APPS on your device
Disconnect your device; the app should be available for use

I have side-loaded an app as described above, but app settings won't work. Why is this?

My app uses app settings, and it sometimes crashes after changing the settings, but the rest of the time it works fine. What can cause this?

In the past, there have been issues where the client used to manage app settings, like Garmin Express or Garmin Connect Mobile, has returned a setting value with an unexpected type, so it's good practice to check a setting value to ensure it's the expected type. For example, this code will check for a null value and convert the value to a Number as long as it is not null. Otherwise, a default value is returned:

function readKeyInt(myApp,key,thisDefault) {
    var value = myApp.getProperty(key);
    if(value == null || !(value instanceof Number)) {
        if(value != null) {
            value = value.toNumber();
        } else {
            value = thisDefault;
        }
    }
    return value;
}

I keep getting a "Too Many Arguments Error", but I never used to get this. What is going on?

Missing state arguments for the onStart() and onStop() methods. These are currently unused arguments and were passed implicitly in earlier versions of Connect IQ, but must now be included explicitly.
An initialize() method that takes an array of options but to which none are passed.

How can I test or debug Connect IQ apps I am developing?

For more advanced debugging, Connect IQ has a unit testing framework called Run No Evil, and a debugger that's included in the Connect IQ plug-in for Eclipse that can be used to dig into potential issues within the Connect IQ simulator. Check out the How to Test chapter of the Programmer's Guide for more info.

In addition to these tools, there are two general types of on-device crash that can occur related to Connect IQ, which each generate log files: app crashes and device crashes.

I think that I've found a bug with CIQ. How do I report it?

If you think you've found a Connect IQ bug, please report it in the Connect IQ Bug Reports tool! Please make sure to read the Bug Reporting Rules to ensure you provide us with the information we need to investigate the problem. Be advised that if you post about a bug in the discussion forum, your thread may be moved or deleted.

Tags: Getting Started, New Developer, CIQ, Connect IQ, New

New Developer FAQ

Brandon.ConnectIQ — Wed, 03 Apr 2019 22:03:48 GMT

Revision 11 posted to Wiki by Brandon.ConnectIQ on 4/3/2019 10:03:48 PM

Where can I download the SDK?
How do I get started with Connect IQ?
I just downloaded the latest SDK. Can I build apps that will work on any device that supports Connect IQ?
Am I allowed to charge for my app though the Connect IQ app store?
Can I display seconds on my watch face?
How do I format output padded with leading zeros?
How can I load the apps I develop to my device for testing purposes?
I have side-loaded an app as described above, but app settings won't work. Why is this?
My app uses app settings, and it sometimes crashes after changing the settings, but the rest of the time it works fine. What can cause this?
I keep getting a "Too Many Arguments Error", but I never used to get this. What is going on?
How can I test or debug Connect IQ apps I am developing?
I think that I've found a bug with CIQ. How do I report it?

Where can I download the SDK?

The latest version of the SDK can be found at http://developer.garmin.com/connect-iq/sdk/.

How do I get started with Connect IQ?

The Programmer's Guide and User Experience Guide are good places to start gaining familiarity with Monkey C and Connect IQ.
API Documentation is available on our developer site.
The SDK also includes a set of sample apps in the 'samples' folder that demonstrate the capabilities of Connect IQ.

I just downloaded the latest SDK. Can I build apps that will work on any device that supports Connect IQ?

Minimum SDK Selected	Eligible Target Devices	What Gets Built
3.0.x	A	3.0.x PRG for A
2.4.x	A, B	3.0.x PRG for A, 2.4.x PRG for B
1.2.x	A, B, C	3.0.x PRG for A, 2.4.x PRG for B, 1.2.x PRG for C

Am I allowed to charge for my app though the Connect IQ app store?

Can I display seconds on my watch face?

You can find out more about low power mode, full power mode, and Always On watch faces in the Programmer's Guide and User Experience Guide, or read about the related APIs in the API Docs.

How do I format output padded with leading zeros?

How can I load the apps I develop to my device for testing purposes?

In Eclipse, choose Connect IQ > Build for Device Wizard…
In the Build for Device Wizard window:
- Choose the project you wish to build
- Choose the target device
- Choose the SDK version to target
- Specify a signing key
- Set an output location
- Click Finish
Connect your device to the computer via USB (it should appear as a drive)
Copy the PRG file made by the Build for Device Wizard from the output location to /GARMIN/APPS on your device
Disconnect your device; the app should be available for use

I have side-loaded an app as described above, but app settings won't work. Why is this?

My app uses app settings, and it sometimes crashes after changing the settings, but the rest of the time it works fine. What can cause this?

In the past, there have been issues where the client used to manage app settings, like Garmin Express or Garmin Connect Mobile, has returned a setting value with an unexpected type, so it's good practice to check a setting value to ensure it's the expected type. For example, this code will check for a null value and convert the value to a Number as long as it is not null. Otherwise, a default value is returned:

function readKeyInt(myApp,key,thisDefault) {
    var value = myApp.getProperty(key);
    if(value == null || !(value instanceof Number)) {
        if(value != null) {
            value = value.toNumber();
        } else {
            value = thisDefault;
        }
    }
    return value;
}

I keep getting a "Too Many Arguments Error", but I never used to get this. What is going on?

Missing state arguments for the onStart() and onStop() methods. These are currently unused arguments and were passed implicitly in earlier versions of Connect IQ, but must now be included explicitly.
An initialize() method that takes an array of options but to which none are passed.

How can I test or debug Connect IQ apps I am developing?

For more advanced debugging, Connect IQ has a unit testing framework called Run No Evil, and a debugger that's included in the Connect IQ plug-in for Eclipse that can be used to dig into potential issues within the Connect IQ simulator. Check out the How to Test chapter of the Programmer's Guide for more info.

In addition to these tools, there are two general types of on-device crash that can occur related to Connect IQ, which each generate log files: app crashes and device crashes.

I think that I've found a bug with CIQ. How do I report it?

If you think you've found a Connect IQ bug, please report it in the Connect IQ Bug Reports tool! Please make sure to read the Bug Reporting Rules to ensure you provide us with the information we need to investigate the problem. Be advised that if you post about a bug in the discussion forum, your thread may be moved or deleted.

Tags: Getting Started, New Developer, CIQ, Connect IQ, New

New Developer FAQ

Brandon.ConnectIQ — Wed, 03 Apr 2019 21:19:10 GMT

Revision 10 posted to Wiki by Brandon.ConnectIQ on 4/3/2019 9:19:10 PM

Where can I download the SDK?
How do I get started with Connect IQ?
Am I allowed to charge for my app though the Connect IQ app store?
Can I display seconds on my watch face?
How do I format output padded with leading zeros?
How can I load the apps I develop to my device for testing purposes?
I have side-loaded an app as described above, but app settings won't work. Why is this?
How can I test or debug Connect IQ apps I am developing?

Where can I download the SDK?

The latest version of the SDK can be found at http://developer.garmin.com/connect-iq/sdk/.

How do I get started with Connect IQ?

The Programmer's Guide and User Experience Guide are good places to start gaining familiarity with Monkey C and Connect IQ.
API Documentation is available on our developer site.
The SDK also includes a set of sample apps in the 'samples' folder that demonstrate the capabilities of Connect IQ.

Am I allowed to charge for my app though the Connect IQ app store?

Can I display seconds on my watch face?

You can find out more about low power mode, full power mode, and Always On watch faces in the Programmer's Guide and User Experience Guide, or read about the related APIs in the API Docs.

How do I format output padded with leading zeros?

How can I load the apps I develop to my device for testing purposes?

In Eclipse, choose Connect IQ > Build for Device Wizard…
In the Build for Device Wizard window:
- Choose the project you wish to build
- Choose the target device
- Choose the SDK version to target
- Specify a signing key
- Set an output location
- Click Finish
Connect your device to the computer via USB (it should appear as a drive)
Copy the PRG file made by the Build for Device Wizard from the output location to /GARMIN/APPS on your device
Disconnect your device; the app should be available for use

I have side-loaded an app as described above, but app settings won't work. Why is this?

How can I test or debug Connect IQ apps I am developing?

For more advanced debugging, Connect IQ has a unit testing framework called Run No Evil, and a debugger that's included in the Connect IQ plug-in for Eclipse that can be used to dig into potential issues within the Connect IQ simulator. Check out the How to Test chapter of the Programmer's Guide for more info.

In addition to these tools, there are two general types of on-device crash that can occur related to Connect IQ, which each generate log files: app crashes and device crashes. App crashes typically result in an app quitting unexpectedly or displaying an 'IQ!' icon, but does not cause the entire device to crash or reboot. This kind of crash is most commonly due to a bug in an app, though it can also be due to a bug in Connect IQ itself. Whenever an app crash occurs, a /GARMIN/APPS/LOGS/CIQ_LOG.YML file is written to the device, which usually contains a call stack from the app (older devices may write a CIQ_LOG.TXT file). Device crashes typically cause the device to reboot or freeze. These indicate a Connect IQ or device firmware bug, and should be much less common than app crashes. When a device crash occurs, an ERR_LOG.TXT file is typically written to /GARMIN or /GARMIN/DEBUG on the device, containing stack trace information related to the crash. Garmin's device teams can take a look at the device crash logs to determine the cause of the crash and will typically provide a fix in a future firmware release.

9. I just downloaded the latest SDK. Can I build apps that will work on any device that supports Connect IQ?

Yes! We have designed the SDK so that you can target any Connect IQ-compatible devices, whether they support version 1.2.x, 1.3.x, or 2.1.x.

Anything built for 1.2.x devices will work on 1.3.x and 2.1.x devices, so it's the most inclusive approach as long as you don't need the newest features for your app. Building for 2.1.x will limit the devices you can target, but will give you access to all of the latest goodies.

In the 2.1.2 SDK release, we added an option to the App Export Wizard that allows you to select a target Connect IQ version, which limits the selectable target devices to only those that support the Connect IQ version you've chosen. The only decision for you to make is which devices you would like to support. Here's a handy-dandy table to help with that choice:

1.2.x Devices (Aikido)	1.4.x Devices (Aikido)	2.1.x Devices (Biker)
epix	D2 Bravo	Approach S60
	D2 Bravo Titanium	D2 Charlie
	Forerunner 230	Edge 520
	Forerunner 235	Edge 820
	Forerunner 630	Edge Explore 820
	Forerunner 920XT	Edge 1000
	fenix 3	Edge Explore 1000
	fenix 3 HR	Forerunner 735XT
	quatix 3	Forerunner 935
	tactix Bravo	fenix 5
	vivoactive	fenix 5S
		fenix 5X
		fenix Chronos
		Oregon 7xx Series
		quatix 5
		Rino 7xx Series
		vivoactive HR

10. My app uses app settings, and it sometimes crashes after changing the settings, but the rest of the time it works fine. What can cause this?

With GCM for Android there is an issue where it sets a value as a Float when a Number is expected. It's good practice to check the value to ensure it's the expected type. For example, this code will check for a null value and convert the value to a Number as long as it is not null. Otherwise, a default value is returned:

function readKeyInt(myApp,key,thisDefault) {
    var value = myApp.getProperty(key);
    if(value == null || !(value instanceof Number)) {
        if(value != null) {
            value = value.toNumber();
        } else {
            value = thisDefault;
        }
    }
    return value;
}

11. I think that I've found a bug with CIQ. Where do I report it?

If you think you've found a bug in the platform we have a Bug Reports tool here in the community. Please make sure to read the Bug Reports Wiki and follow the directions there on rules and usage there. If you post about a bug in the regular forums your thread may be moved or deleted.

12. I keep getting a "Too Many Arguments Error", but I never used to get this. What is going on?

We added a functionality in the 2.1.2 SDK release to perform an argument count check on function and method calls. This was included as part of a larger security effort, which includes things like app signing and encryption of app data. Overall, this is a good thing, since it promotes more robust source code prevents some potential security exploits. Unfortunately, it has also caused some apps to crash on 1.3.x and 2.1.x devices when built with the 2.1.2 SDK even though these same apps execute without issue when built with earlier SDK releases. This kind of crash appears in the CIQ_LOG.txt file as a "Too many arguments" error, signifying the argument count check has failed.

In most cases, the culprits behind this "Too many arguments" issue are missing 'state' arguments for onStart() and onStop(). These are currently unused argument and were passed implicitly in earlier versions of Connect IQ, but must now be included explicitly. Another example that can cause this is something like an initialize() function for a Drawable, which takes an array of options but to which none are passed.

The new minimum SDK selector is designed to build for the highest supported SDK for each device. For example, consider this set of devices: device A (2.1.x), B (1.3.x), and C (1.2.x). The table below illustrates how the build system is designed to function:

Minimum SDK Selected	Available Target Devices	What We Build
2.1.x	A	2.1.x PRG for A
1.3.x	A, B	2.1.x PRG for A, 1.3.x PRG for B,
1.2.x	A, B, C	2.1.x PRG for A, 1.3.x PRG for B, 1.2.x PRG for C

It can sometimes be difficult to troubleshoot this issue due to a bug in our build system. The Build For Device Wizard may build a PRG for a target VM version lower than expected for a given device. The result is that a PRG made with the Build For Device Wizard will operate without issue on a device, but the same app will fail with a "Too many arguments" error when using a PRG from the App Export Wizard (i.e. installed from the store). As a consequence, it can be difficult to obtain a useful call stack in the CIQ_LOG.txt. We have a fix for this that will be included in an upcoming release of the SDK.

Tags: Getting Started, New Developer, CIQ, Connect IQ, New

New Developer FAQ

Brandon.ConnectIQ — Wed, 03 Apr 2019 20:58:11 GMT

Revision 9 posted to Wiki by Brandon.ConnectIQ on 4/3/2019 8:58:11 PM

Where can I download the SDK?
How do I get started with Connect IQ?
Am I allowed to charge for my app though the Connect IQ app store?
Can I display seconds on my watch face?
How do I format output padded with leading zeros?
How can I load the apps I develop to my device for testing purposes?

Where can I download the SDK?

The latest version of the SDK can be found at http://developer.garmin.com/connect-iq/sdk/.

How do I get started with Connect IQ?

The Programmer's Guide and User Experience Guide are good places to start gaining familiarity with Monkey C and Connect IQ.
API Documentation is available on our developer site.
The SDK also includes a set of sample apps in the 'samples' folder that demonstrate the capabilities of Connect IQ.

Am I allowed to charge for my app though the Connect IQ app store?

Can I display seconds on my watch face?

You can find out more about low power mode, full power mode, and Always On watch faces in the Programmer's Guide and User Experience Guide, or read about the related APIs in the API Docs.

How do I format output padded with leading zeros?

Many Connect IQ apps include time values that require leading zeros. For example, time written in an HH:MM:SS format appears as 12:05:05 rather than 12:5:5. Monkey C includes string formatting functions that can get this job done using a %02d format specifier.

How can I load the apps I develop to my device for testing purposes?

In Eclipse, choose Connect IQ > Build for Device Wizard…
In the Build for Device Wizard window:
- Choose the project you wish to build
- Choose the target device
- Choose the SDK version to target
- Specify a signing key
- Set an output location
- Click Finish
Connect your device to the computer via USB (it should appear as a drive)
Copy the PRG file made by the Build for Device Wizard from the output location to /GARMIN/APPS on your device
Disconnect your device; the app should be available for use

I have side-loaded an app as described above, but app settings won't work. Why is this?

App settings allow user to configure an app via Garmin Express or Garmin Connect Mobile, and rely on the Connect IQ App Store to function properly. When an app is side loaded, this connection to the Connect IQ App Store is never established. If you have an app that uses app settings that needs to be tested, you may submit the app to the Connect IQ App Store and test out the settings features while the app is still pending approval.

8. How can I test or debug Connect IQ apps I am developing?

The best way to currently test Connect IQ apps is to include System.println() statements at strategic points in your app. Within Eclipse, these println() statements will output to the console. On a device, println() statements write to an <APPNAME>.TXT file in /GARMIN/APPS/LOGS. These log files are not automatically created, so must be manually created on the device and named to match the name of the app's corresponding PRG file. For example, to log output from /GARMIN/APPS/MYAPP.PRG, you must create /GARMIN/APPS/LOGS/MYAPP.TXT.

Aside from this basic debugging technique, there are two general types of on-device crash that can occur related to Connect IQ, which each generate log files: app crashes and device crashes. App crashes typically result in an app quitting unexpectedly or displaying an 'IQ!' icon, but does not cause the entire device to crash or reboot. This kind of crash is most commonly due to a bug in an app, though it can also be due to a bug in Connect IQ itself. Whenever an app crash occurs, a CIQ_LOG.txt file is written to /GARMIN/APPS/LOGSon the device, and contains information related to the crash that app developers may use to address the problem. Device crashes typically cause the device to reboot or freeze. These indicate a Connect IQ or device firmware bug, and should be much less common than app crashes. When a device crash occurs, an ERR_LOG.txt file is written to /GARMIN on the device, containing stack trace information related to the crash. Garmin's device teams can take a look at the device crash logs to determine the cause of the crash and will typically provide a fix in a future firmware release.

When any log file exceeds 5kb, it will automatically be archived to <LOGNAME>.BAK, and a new log will be started. Any old .BAK files will be overwritten when the archive occurs, so the max space a log can reach is ~10kb.

1.2.x Devices (Aikido)	1.4.x Devices (Aikido)	2.1.x Devices (Biker)
epix	D2 Bravo	Approach S60
	D2 Bravo Titanium	D2 Charlie
	Forerunner 230	Edge 520
	Forerunner 235	Edge 820
	Forerunner 630	Edge Explore 820
	Forerunner 920XT	Edge 1000
	fenix 3	Edge Explore 1000
	fenix 3 HR	Forerunner 735XT
	quatix 3	Forerunner 935
	tactix Bravo	fenix 5
	vivoactive	fenix 5S
		fenix 5X
		fenix Chronos
		Oregon 7xx Series
		quatix 5
		Rino 7xx Series
		vivoactive HR

function readKeyInt(myApp,key,thisDefault) {
    var value = myApp.getProperty(key);
    if(value == null || !(value instanceof Number)) {
        if(value != null) {
            value = value.toNumber();
        } else {
            value = thisDefault;
        }
    }
    return value;
}

Minimum SDK Selected	Available Target Devices	What We Build
2.1.x	A	2.1.x PRG for A
1.3.x	A, B	2.1.x PRG for A, 1.3.x PRG for B,
1.2.x	A, B, C	2.1.x PRG for A, 1.3.x PRG for B, 1.2.x PRG for C

Tags: Getting Started, New Developer, CIQ, Connect IQ, New

New Developer FAQ

Brandon.ConnectIQ — Wed, 03 Apr 2019 20:57:11 GMT

Revision 8 posted to Wiki by Brandon.ConnectIQ on 4/3/2019 8:57:11 PM

Where can I download the SDK?
How do I get started with Connect IQ?
Am I allowed to charge for my app though the Connect IQ app store?
Can I display seconds on my watch face?
How do I format output padded with leading zeros?
How can I load the apps I develop to my device for testing purposes?

Where can I download the SDK?

The latest version of the SDK can be found at http://developer.garmin.com/connect-iq/sdk/.

How do I get started with Connect IQ?

The Programmer's Guide and User Experience Guide are good places to start gaining familiarity with Monkey C and Connect IQ.
API Documentation is available on our developer site.
The SDK also includes a set of sample apps in the 'samples' folder that demonstrate the capabilities of Connect IQ.

Am I allowed to charge for my app though the Connect IQ app store?

Can I display seconds on my watch face?

You can find out more about low power mode, full power mode, and Always On watch faces in the Programmer's Guide and User Experience Guide, or read about the related APIs in the API Docs.

How do I format output padded with leading zeros?

How can I load the apps I develop to my device for testing purposes?

In Eclipse, choose Connect IQ > Build for Device Wizard…
In the Build for Device Wizard window:
- Choose the project you wish to build
- Choose the target device
- Choose the SDK version to target
- Specify a signing key
- Set an output location
- Click Finish
Connect your device to the computer via USB (it should appear as a drive)
Copy the PRG file made by the Build for Device Wizard from the output location to /GARMIN/APPS on your device
Disconnect your device; the app should be available for use

7. I have side-loaded an app as described above, but app settings won't work. Why is this?

App settings allow user to configure an app via Garmin Express or Garmin Connect Mobile, and rely on the Connect IQ App Store to function properly. When an app is side loaded, this connection to the Connect IQ App Store is never established. If you have an app that uses app settings that needs to be tested, you may submit the app to the Connect IQ App Store and test out the settings features while the app is still pending approval.

8. How can I test or debug Connect IQ apps I am developing?

The best way to currently test Connect IQ apps is to include System.println() statements at strategic points in your app. Within Eclipse, these println() statements will output to the console. On a device, println() statements write to an <APPNAME>.TXT file in /GARMIN/APPS/LOGS. These log files are not automatically created, so must be manually created on the device and named to match the name of the app's corresponding PRG file. For example, to log output from /GARMIN/APPS/MYAPP.PRG, you must create /GARMIN/APPS/LOGS/MYAPP.TXT.

Aside from this basic debugging technique, there are two general types of on-device crash that can occur related to Connect IQ, which each generate log files: app crashes and device crashes. App crashes typically result in an app quitting unexpectedly or displaying an 'IQ!' icon, but does not cause the entire device to crash or reboot. This kind of crash is most commonly due to a bug in an app, though it can also be due to a bug in Connect IQ itself. Whenever an app crash occurs, a CIQ_LOG.txt file is written to /GARMIN/APPS/LOGSon the device, and contains information related to the crash that app developers may use to address the problem. Device crashes typically cause the device to reboot or freeze. These indicate a Connect IQ or device firmware bug, and should be much less common than app crashes. When a device crash occurs, an ERR_LOG.txt file is written to /GARMIN on the device, containing stack trace information related to the crash. Garmin's device teams can take a look at the device crash logs to determine the cause of the crash and will typically provide a fix in a future firmware release.

When any log file exceeds 5kb, it will automatically be archived to <LOGNAME>.BAK, and a new log will be started. Any old .BAK files will be overwritten when the archive occurs, so the max space a log can reach is ~10kb.

1.2.x Devices (Aikido)	1.4.x Devices (Aikido)	2.1.x Devices (Biker)
epix	D2 Bravo	Approach S60
	D2 Bravo Titanium	D2 Charlie
	Forerunner 230	Edge 520
	Forerunner 235	Edge 820
	Forerunner 630	Edge Explore 820
	Forerunner 920XT	Edge 1000
	fenix 3	Edge Explore 1000
	fenix 3 HR	Forerunner 735XT
	quatix 3	Forerunner 935
	tactix Bravo	fenix 5
	vivoactive	fenix 5S
		fenix 5X
		fenix Chronos
		Oregon 7xx Series
		quatix 5
		Rino 7xx Series
		vivoactive HR

function readKeyInt(myApp,key,thisDefault) {
    var value = myApp.getProperty(key);
    if(value == null || !(value instanceof Number)) {
        if(value != null) {
            value = value.toNumber();
        } else {
            value = thisDefault;
        }
    }
    return value;
}

Minimum SDK Selected	Available Target Devices	What We Build
2.1.x	A	2.1.x PRG for A
1.3.x	A, B	2.1.x PRG for A, 1.3.x PRG for B,
1.2.x	A, B, C	2.1.x PRG for A, 1.3.x PRG for B, 1.2.x PRG for C

Tags: Getting Started, New Developer, CIQ, Connect IQ, New

New Developer FAQ

Brandon.ConnectIQ — Wed, 03 Apr 2019 20:54:55 GMT

Revision 7 posted to Wiki by Brandon.ConnectIQ on 4/3/2019 8:54:55 PM

Where can I download the SDK?
How do I get started with Connect IQ?
Am I allowed to charge for my app though the Connect IQ app store?
Can I display seconds on my watch face?
How do I format output padded with leading zeros?
How can I load the apps I develop to my device for testing purposes?

Where can I download the SDK?

The latest version of the SDK can be found at http://developer.garmin.com/connect-iq/sdk/.

How do I get started with Connect IQ?

The Programmer's Guide and User Experience Guide are good places to start gaining familiarity with Monkey C and Connect IQ.
API Documentation is available on our developer site.
The SDK also includes a set of sample apps in the 'samples' folder that demonstrate the capabilities of Connect IQ.

Am I allowed to charge for my app though the Connect IQ app store?

Can I display seconds on my watch face?

You can find out more about low power mode, full power mode, and Always On watch faces in the Programmer's Guide and User Experience Guide, or read about the related APIs in the API Docs.

How do I format output padded with leading zeros?

How can I load the apps I develop to my device for testing purposes?

In Eclipse, choose Connect IQ > Build for Device Wizard…
In the Build for Device Wizard window:
- Choose the project you wish to build
- Choose the target device
- Choose the SDK version to target
- Specify a signing key
- Set an output location
- Click Finish
Connect your device to the computer via USB (it should appear as a drive)
Copy the PRG file made by the Build for Device Wizard from the output location to /GARMIN/APPS on your device
Disconnect your device; the app should be available for use

1.2.x Devices (Aikido)	1.4.x Devices (Aikido)	2.1.x Devices (Biker)
epix	D2 Bravo	Approach S60
	D2 Bravo Titanium	D2 Charlie
	Forerunner 230	Edge 520
	Forerunner 235	Edge 820
	Forerunner 630	Edge Explore 820
	Forerunner 920XT	Edge 1000
	fenix 3	Edge Explore 1000
	fenix 3 HR	Forerunner 735XT
	quatix 3	Forerunner 935
	tactix Bravo	fenix 5
	vivoactive	fenix 5S
		fenix 5X
		fenix Chronos
		Oregon 7xx Series
		quatix 5
		Rino 7xx Series
		vivoactive HR

function readKeyInt(myApp,key,thisDefault) {
    var value = myApp.getProperty(key);
    if(value == null || !(value instanceof Number)) {
        if(value != null) {
            value = value.toNumber();
        } else {
            value = thisDefault;
        }
    }
    return value;
}

Minimum SDK Selected	Available Target Devices	What We Build
2.1.x	A	2.1.x PRG for A
1.3.x	A, B	2.1.x PRG for A, 1.3.x PRG for B,
1.2.x	A, B, C	2.1.x PRG for A, 1.3.x PRG for B, 1.2.x PRG for C

Tags: Getting Started, New Developer, CIQ, Connect IQ, New

New Developer FAQ

Former Member — Fri, 29 Mar 2019 20:08:10 GMT

Revision 6 posted to Wiki by Former Member on 3/29/2019 8:08:10 PM

Welcome to the Connect IQ forums!

Below are some of the most common questions and answers we see on the forums. We'll add to the FAQ over time, so check back now and then for updates!

Definitions
app - Generic term for all Connect IQ four application types: watch face, watch app, widget, and data field. The "watch-app" type is commonly just referred to as an "application" and may run on non-watch-like devices like the Edge or Oregon series devices.
APAC - Asia-Pacific, which includes China, Taiwan, Japan, Indonesia, Malaysia, and Singapore
API - Application Programming Interface; the specific software routines supported by the SDK used to write Connect IQ apps
CIQ - Connect IQ
GCM - Garmin Connect Mobile
GE - Garmin Express
SDK - Software Development Kit; the tool set which developers use to create Connect IQ apps
VM - Virtual Machine; the software on Garmin devices that runs Connect IQ apps

1. Where can I download the SDK?

You can find noth Mac and Windows version of the SDK at developer.garmin.com: http://developer.garmin.com/connect-iq/sdk/

2. How do I get started with Connect IQ?

The Programmer's Guide and User Experience Guide are good references to start gaining familiarity with Monkey C and Connect IQ. These are also included with the SDK as PDFs for offline reference. The SDK also includes a set of sample apps that demonstrate the capabilities of Connect IQ.

If you have questions along the way, these forums are the best place to go for assistance. Many questions have already been answered in previously posted threads, however both the Connect IQ team and several experienced developers monitor the forums to answer new questions or respond to issues you may encounter.

3. Am I allowed to charge for my app though the Connect IQ app store?

Yes, you are! It is acceptable to list prices, link to payment sites, or ask for donations on the Connect IQ app store as long as solicitations are related to your app. The app store falls under the the Connect IQ SDK License Agreement, which does not forbid solicitation for sales of apps by app developers. However, solicitation for business on other Garmin web sites, including this forum, is prohibited but Garmin's Terms of Use.

https://forums.garmin.com/showthread...this-forbidden

4. Can I display seconds on my watch face?

Yes, you can! However, a priority of Connect IQ is the preservation of battery life, so we have a system in place that governs how often watch faces may be updated. Watch faces update at once a minute in low power mode, and once a second when in full power mode. The watch will enter full power mode for a few seconds when the user gestures to look at it, and then return to low power mode. Developers will often detect this transition to full power mode, display a seconds indicator for a few moments, and then hide the seconds indicator once the device returns to low power mode. You can find out more about the low power and full power mode transition in the User Experience Guide, or read about the specifics of detecting these transitions in the API Docs.

https://forums.garmin.com/showthread...e-with-Seconds

5. How do I format output padded with leading zeros?

Many Connect IQ apps include time values that require leading zeros. For example, time written in an HH:MM:SS format appears as 12:05:05 rather than 12:5:5. Monkey C includes string formatting functions that can get this job done using a "%02d" format specifier.

A common error is to specify a format of "%.2d" or "%0.2d". This may pad a decimal with leading zeros in some languages, such as in C++'s printf() function, but Monkey C follows the C99 standard. C99 requires the '0' flag to specify padding with leading zeros for d, i, o, u, x, X, a, A, e, f, F, g, and G conversions. In addition, if a precision is specified with '.', according to C99 the the '0' flag is ignored.

https://forums.garmin.com/showthread...rmatted-Output

6. How can I load the apps I develop to my device for testing purposes?

Apps are typically installed to devices via the Connect IQ App Store, but it's often useful to side-load an app to a device for testing without having to first upload a version to the app store. Here's how:

In Eclipse, choose Connect IQ > Build for Device Wizard…
In the Build for Device Tool window:
- Choose the project you wish to build
- Choose the target device
- Set an output location
- Click Finish
Connect your device to the computer via USB (it should connect as mass storage and appear as a drive)
Copy the resultant PRG file from the output location to /GARMIN/APPS on your device
Disconnect your device; the app should be available for use

1.2.x Devices (Aikido)	1.4.x Devices (Aikido)	2.1.x Devices (Biker)
epix	D2 Bravo	Approach S60
	D2 Bravo Titanium	D2 Charlie
	Forerunner 230	Edge 520
	Forerunner 235	Edge 820
	Forerunner 630	Edge Explore 820
	Forerunner 920XT	Edge 1000
	fenix 3	Edge Explore 1000
	fenix 3 HR	Forerunner 735XT
	quatix 3	Forerunner 935
	tactix Bravo	fenix 5
	vivoactive	fenix 5S
		fenix 5X
		fenix Chronos
		Oregon 7xx Series
		quatix 5
		Rino 7xx Series
		vivoactive HR

function readKeyInt(myApp,key,thisDefault) {
    var value = myApp.getProperty(key);
    if(value == null || !(value instanceof Number)) {
        if(value != null) {
            value = value.toNumber();
        } else {
            value = thisDefault;
        }
    }
    return value;
}

Minimum SDK Selected	Available Target Devices	What We Build
2.1.x	A	2.1.x PRG for A
1.3.x	A, B	2.1.x PRG for A, 1.3.x PRG for B,
1.2.x	A, B, C	2.1.x PRG for A, 1.3.x PRG for B, 1.2.x PRG for C

Tags: Getting Started, New Developer, CIQ, Connect IQ, New

New Developer FAQ

Former Member — Fri, 29 Mar 2019 19:53:37 GMT

Revision 5 posted to Wiki by Former Member on 3/29/2019 7:53:37 PM

In Eclipse, choose Connect IQ > Build for Device Wizard…
In the Build for Device Tool window:
- Choose the project you wish to build
- Choose the target device
- Set an output location
- Click Finish
Connect your device to the computer via USB (it should connect as mass storage and appear as a drive)
Copy the resultant PRG file from the output location to /GARMIN/APPS on your device
Disconnect your device; the app should be available for use

1.2.x Devices (Aikido)	1.4.x Devices (Aikido)	2.1.x Devices (Biker)
epix	D2 Bravo	Approach S60
	D2 Bravo Titanium	D2 Charlie
	Forerunner 230	Edge 520
	Forerunner 235	Edge 820
	Forerunner 630	Edge Explore 820
	Forerunner 920XT	Edge 1000
	fenix 3	Edge Explore 1000
	fenix 3 HR	Forerunner 735XT
	quatix 3	Forerunner 935
	tactix Bravo	fenix 5
	vivoactive	fenix 5S
		fenix 5X
		fenix Chronos
		Oregon 7xx Series
		quatix 5
		Rino 7xx Series
		vivoactive HR

function readKeyInt(myApp,key,thisDefault) {
    var value = myApp.getProperty(key);
    if(value == null || !(value instanceof Number)) {
        if(value != null) {
            value = value.toNumber();
        } else {
            value = thisDefault;
        }
    }
    return value;
}

11. I think that I've found a bug with CIQ. Where do I report it?

If you think you've found a bug in the platform we have a Bug Reports tool here in the community. Please make sure to read the Bug Reports Wiki and follow the directions there. If you post about a bug in the regular forums your thread may be moved or deleted.

12. I keep getting a "Too Many Arguments Error", but I never used to get this. What is going on?

We added a functionality in the 2.1.2 SDK release to perform an argument count check on function and method calls. This was included as part of a larger security effort, which includes things like app signing and encryption of app data. Overall, this is a good thing, since it promotes more robust source code prevents some potential security exploits. Unfortunately, it has also caused some apps to crash on 1.3.x and 2.1.x devices when built with the 2.1.2 SDK even though these same apps execute without issue when built with earlier SDK releases. This kind of crash appears in the CIQ_LOG.txt file as a "Too many arguments" error, signifying the argument count check has failed.

In most cases, the culprits behind this "Too many arguments" issue are missing 'state' arguments for onStart() and onStop(). These are currently unused argument and were passed implicitly in earlier versions of Connect IQ, but must now be included explicitly. Another example that can cause this is something like an initialize() function for a Drawable, which takes an array of options but to which none are passed.

The new minimum SDK selector is designed to build for the highest supported SDK for each device. For example, consider this set of devices: device A (2.1.x), B (1.3.x), and C (1.2.x). The table below illustrates how the build system is designed to function:

Minimum SDK Selected	Available Target Devices	What We Build
2.1.x	A	2.1.x PRG for A
1.3.x	A, B	2.1.x PRG for A, 1.3.x PRG for B,
1.2.x	A, B, C	2.1.x PRG for A, 1.3.x PRG for B, 1.2.x PRG for C

Tags: Getting Started, New Developer, CIQ, Connect IQ, New

New Developer FAQ

Former Member — Fri, 29 Mar 2019 19:44:24 GMT

Revision 4 posted to Wiki by Former Member on 3/29/2019 7:44:24 PM

In Eclipse, choose Connect IQ > Build for Device Wizard…
In the Build for Device Tool window:
- Choose the project you wish to build
- Choose the target device
- Set an output location
- Click Finish
Connect your device to the computer via USB (it should connect as mass storage and appear as a drive)
Copy the resultant PRG file from the output location to /GARMIN/APPS on your device
Disconnect your device; the app should be available for use

1.2.x Devices (Aikido)	1.4.x Devices (Aikido)	2.1.x Devices (Biker)
epix	D2 Bravo	Approach S60
	D2 Bravo Titanium	D2 Charlie
	Forerunner 230	Edge 520
	Forerunner 235	Edge 820
	Forerunner 630	Edge Explore 820
	Forerunner 920XT	Edge 1000
	fenix 3	Edge Explore 1000
	fenix 3 HR	Forerunner 735XT
	quatix 3	Forerunner 935
	tactix Bravo	fenix 5
	vivoactive	fenix 5S
		fenix 5X
		fenix Chronos
		Oregon 7xx Series
		quatix 5
		Rino 7xx Series
		vivoactive HR

function readKeyInt(myApp,key,thisDefault) {
    var value = myApp.getProperty(key);
    if(value == null || !(value instanceof Number)) {
        if(value != null) {
            value = value.toNumber();
        } else {
            value = thisDefault;
        }
    }
    return value;
}

11. I think that I've found a bug with CIQ. Where do I report it?

If you think you've found a bug in the platform we have a Connect IQ Bug Reports Sub-Forum here. Please make sure to read the rules sticky thread and follow the directions there. If you post about a bug in the regular forums your thread may be moved or deleted.

12. I keep getting a "Too Many Arguments Error", but I never used to get this. What is going on?

We added a functionality in the 2.1.2 SDK release to perform an argument count check on function and method calls. This was included as part of a larger security effort, which includes things like app signing and encryption of app data. Overall, this is a good thing, since it promotes more robust source code prevents some potential security exploits. Unfortunately, it has also caused some apps to crash on 1.3.x and 2.1.x devices when built with the 2.1.2 SDK even though these same apps execute without issue when built with earlier SDK releases. This kind of crash appears in the CIQ_LOG.txt file as a "Too many arguments" error, signifying the argument count check has failed.

In most cases, the culprits behind this "Too many arguments" issue are missing 'state' arguments for onStart() and onStop(). These are currently unused argument and were passed implicitly in earlier versions of Connect IQ, but must now be included explicitly. Another example that can cause this is something like an initialize() function for a Drawable, which takes an array of options but to which none are passed.

The new minimum SDK selector is designed to build for the highest supported SDK for each device. For example, consider this set of devices: device A (2.1.x), B (1.3.x), and C (1.2.x). The table below illustrates how the build system is designed to function:

Minimum SDK Selected	Available Target Devices	What We Build
2.1.x	A	2.1.x PRG for A
1.3.x	A, B	2.1.x PRG for A, 1.3.x PRG for B,
1.2.x	A, B, C	2.1.x PRG for A, 1.3.x PRG for B, 1.2.x PRG for C

Tags: Getting Started, New Developer, CIQ, Connect IQ, New

New Developer FAQ

Former Member — Fri, 29 Mar 2019 19:41:44 GMT

Revision 3 posted to Wiki by Former Member on 3/29/2019 7:41:44 PM

In Eclipse, choose Connect IQ > Build for Device Wizard…
In the Build for Device Tool window:
- Choose the project you wish to build
- Choose the target device
- Set an output location
- Click Finish
Connect your device to the computer via USB (it should connect as mass storage and appear as a drive)
Copy the resultant PRG file from the output location to /GARMIN/APPS on your device
Disconnect your device; the app should be available for use

1.2.x Devices (Aikido)	1.4.x Devices (Aikido)	2.1.x Devices (Biker)
epix	D2 Bravo	Approach S60
	D2 Bravo Titanium	D2 Charlie
	Forerunner 230	Edge 520
	Forerunner 235	Edge 820
	Forerunner 630	Edge Explore 820
	Forerunner 920XT	Edge 1000
	fenix 3	Edge Explore 1000
	fenix 3 HR	Forerunner 735XT
	quatix 3	Forerunner 935
	tactix Bravo	fenix 5
	vivoactive	fenix 5S
		fenix 5X
		fenix Chronos
		Oregon 7xx Series
		quatix 5
		Rino 7xx Series
		vivoactive HR

function readKeyInt(myApp,key,thisDefault) {
    var value = myApp.getProperty(key);
    if(value == null || !(value instanceof Number)) {
        if(value != null) {
            value = value.toNumber();
        } else {
            value = thisDefault;
        }
    }
    return value;
}

11. I think that I've found a bug with CIQ. Where do I report it?

If you think you've found a bug in the platform we have a Connect IQ Bug Reports Sub-Forum here. Please make sure to read the rules sticky thread and follow the directions there. If you post about a bug in the regular forums your thread may be moved or deleted.

12. I keep getting a "Too Many Arguments Error", but I never used to get this. What is going on?

We added a functionality in the 2.1.2 SDK release to perform an argument count check on function and method calls. This was included as part of a larger security effort, which includes things like app signing and encryption of app data. Overall, this is a good thing, since it promotes more robust source code prevents some potential security exploits. Unfortunately, it has also caused some apps to crash on 1.3.x and 2.1.x devices when built with the 2.1.2 SDK even though these same apps execute without issue when built with earlier SDK releases. This kind of crash appears in the CIQ_LOG.txt file as a "Too many arguments" error, signifying the argument count check has failed.

In most cases, the culprits behind this "Too many arguments" issue are missing 'state' arguments for onStart() and onStop(). These are currently unused argument and were passed implicitly in earlier versions of Connect IQ, but must now be included explicitly. Another example that can cause this is something like an initialize() function for a Drawable, which takes an array of options but to which none are passed.

The new minimum SDK selector is designed to build for the highest supported SDK for each device. For example, consider this set of devices: device A (2.1.x), B (1.3.x), and C (1.2.x). The table below illustrates how the build system is designed to function:

Minimum SDK Selected	Available Target Devices	What We Build
2.1.x	A	2.1.x PRG for A
1.3.x	A, B	2.1.x PRG for A, 1.3.x PRG for B,
1.2.x	A, B, C	2.1.x PRG for A, 1.3.x PRG for B, 1.2.x PRG for C

Tags: Getting Started, New Developer, CIQ, Connect IQ, New

New Developer FAQ

Former Member — Fri, 29 Mar 2019 19:40:48 GMT

Revision 2 posted to Wiki by Former Member on 3/29/2019 7:40:48 PM

In Eclipse, choose Connect IQ > Build for Device Wizard…
In the Build for Device Tool window:
- Choose the project you wish to build
- Choose the target device
- Set an output location
- Click Finish
Connect your device to the computer via USB (it should connect as mass storage and appear as a drive)
Copy the resultant PRG file from the output location to /GARMIN/APPS on your device
Disconnect your device; the app should be available for use

1.2.x Devices (Aikido)	1.4.x Devices (Aikido)	2.1.x Devices (Biker)
epix	D2 Bravo	Approach S60
	D2 Bravo Titanium	D2 Charlie
	Forerunner 230	Edge 520
	Forerunner 235	Edge 820
	Forerunner 630	Edge Explore 820
	Forerunner 920XT	Edge 1000
	fenix 3	Edge Explore 1000
	fenix 3 HR	Forerunner 735XT
	quatix 3	Forerunner 935
	tactix Bravo	fenix 5
	vivoactive	fenix 5S
		fenix 5X
		fenix Chronos
		Oregon 7xx Series
		quatix 5
		Rino 7xx Series
		vivoactive HR

function readKeyInt(myApp,key,thisDefault) {
    var value = myApp.getProperty(key);
    if(value == null || !(value instanceof Number)) {
        if(value != null) {
            value = value.toNumber();
        } else {
            value = thisDefault;
        }
    }
    return value;
}

11. I think that I've found a bug with CIQ. Where do I report it?

If you think you've found a bug in the platform we have a Connect IQ Bug Reports Sub-Forum here. Please make sure to read the rules sticky thread and follow the directions there. If you post about a bug in the regular forums your thread may be moved or deleted.

12. I keep getting a "Too Many Arguments Error", but I never used to get this. What is going on?

We added a functionality in the 2.1.2 SDK release to perform an argument count check on function and method calls. This was included as part of a larger security effort, which includes things like app signing and encryption of app data. Overall, this is a good thing, since it promotes more robust source code prevents some potential security exploits. Unfortunately, it has also caused some apps to crash on 1.3.x and 2.1.x devices when built with the 2.1.2 SDK even though these same apps execute without issue when built with earlier SDK releases. This kind of crash appears in the CIQ_LOG.txt file as a "Too many arguments" error, signifying the argument count check has failed.

In most cases, the culprits behind this "Too many arguments" issue are missing 'state' arguments for onStart() and onStop(). These are currently unused argument and were passed implicitly in earlier versions of Connect IQ, but must now be included explicitly. Another example that can cause this is something like an initialize() function for a Drawable, which takes an array of options but to which none are passed.

The new minimum SDK selector is designed to build for the highest supported SDK for each device. For example, consider this set of devices: device A (2.1.x), B (1.3.x), and C (1.2.x). The table below illustrates how the build system is designed to function:

Minimum SDK Selected	Available Target Devices	What We Build
2.1.x	A	2.1.x PRG for A
1.3.x	A, B	2.1.x PRG for A, 1.3.x PRG for B,
1.2.x	A, B, C	2.1.x PRG for A, 1.3.x PRG for B, 1.2.x PRG for C

Tags: Getting Started, New Developer, CIQ, Connect IQ, New

New Developer FAQ

Former Member — Fri, 29 Mar 2019 19:39:09 GMT

Revision 1 posted to Wiki by Former Member on 3/29/2019 7:39:09 PM

In Eclipse, choose Connect IQ > Build for Device Wizard…
In the Build for Device Tool window:
- Choose the project you wish to build
- Choose the target device
- Set an output location
- Click Finish
Connect your device to the computer via USB (it should connect as mass storage and appear as a drive)
Copy the resultant PRG file from the output location to /GARMIN/APPS on your device
Disconnect your device; the app should be available for use

1.2.x Devices (Aikido)	1.4.x Devices (Aikido)	2.1.x Devices (Biker)
epix	D2 Bravo	Approach S60
	D2 Bravo Titanium	D2 Charlie
	Forerunner 230	Edge 520
	Forerunner 235	Edge 820
	Forerunner 630	Edge Explore 820
	Forerunner 920XT	Edge 1000
	fenix 3	Edge Explore 1000
	fenix 3 HR	Forerunner 735XT
	quatix 3	Forerunner 935
	tactix Bravo	fenix 5
	vivoactive	fenix 5S
		fenix 5X
		fenix Chronos
		Oregon 7xx Series
		quatix 5
		Rino 7xx Series
		vivoactive HR

Code:

function readKeyInt(myApp,key,thisDefault) {
    var value = myApp.getProperty(key);
    if(value == null || !(value instanceof Number)) {
        if(value != null) {
            value = value.toNumber();
        } else {
            value = thisDefault;
        }
    }
    return value;
}

Minimum SDK Selected	Available Target Devices	What We Build
2.1.x	A	2.1.x PRG for A
1.3.x	A, B	2.1.x PRG for A, 1.3.x PRG for B,
1.2.x	A, B, C	2.1.x PRG for A, 1.3.x PRG for B, 1.2.x PRG for C

Tags: Getting Started, New Developer, CIQ, Connect IQ, New