I've read http://www.visualmicro.com/post/2015/10/24/Advanced-Arduino-Local-Libraries-and-... and http://www.visualmicro.com/page/Local-Project-Arduino-API-Source.aspx but cannot get local project libraries to work.

I'm trying to compile the following sketch https://github.com/milesburton/Arduino-Temperature-Control-Library/blob/master/e...

This is my directory structure:

sensor/
    sensor.ino                   # contains the sketch code mentioned above
    src/_micro-api/libraries/
                            DallasTemperature/
                                             DallasTemperature.h
                                             ....
                            OneWire/
                                             OneWire.h
                                             ....
 

The error I get is:

sensor.ino: 3:21: fatal error: OneWire.h: No such file or directory
   #include "OneWire.h"
   compilation terminated


	An error was encountered during the 'Deep Search' discovery process.
	Either resolve the error or switch off the 'Deep Search Includes' option.
	Tip: When deep search is switched off, headers must be #included in the [project_name.ino] for all required libraries (for example: #include <SPI.h>)
	Tip: Deep search must be off if the project source contains links/shortcuts to code outside of the project structure. The source will have been #included using a relative path preceeded by ..\ (for example: #include "..\..\foo\foo.h")
 

I tried disabling deep search via menu vMicro->Compiler->Deep Search Includes, but it seems I cannot disable it? I cannot get rid of the checkbox.


Any advice about what I'm doing wrong?

Tim@Visual Micro wrote on Aug 27^th, 2016 at 5:20pm:


IDE: Microsoft Visual Studio Community 2015 (Version 14.0.25425.01 update 3)
Visual Micro: Version 1608.25.0 (Installed 8/27/2016), Licenced
Arduino IDE: v1.6.11

Hi,

I tried this out and can't get it to go wrong.

So I could do with some info.

Please switch on vmicro>compiler>verbose and "show build properties" and then build and post the output as a .txt file or email to info[at]visualmicro.com with a link back to this post

A screen shot of the solution explorer showing the library folder and file structure would also be useful thanks

Thanks

Excellent thanks

Hi,

No its not recommended. Local libraries are for advanced users and you never need to create the _micro-api folder manually.

1. Delete the physical src folder

2. Remove the src folder from the solution explorer is it still exists.

Libraries are described in the arduino user guide but here are a few tips. The basics are the same in both ide's

1) Manually install a library from a zip using the "vMicro>Add Library>Install Library" which unpack the zip into your "sketch book\libraries folder" normally documents\arduino\libraries. You can also manually unzip your library into the correct location

2) Click the Refresh command on the same install library menu or restart the ide

3) Use the vMicro>Add Library" menu to select the newly installed library. This will add the correct format of #include to the project_name.ino but you can use the same syntax in cpp files.

Adding/using an arduino library in a project does not mean copying code into the local project. Libraries are never included with a path because they are automatically discovered from known areas.

As a simpler alternative to 1) use the "visual micro explorer > library manager" to locate, download and install libraries without messing with zip files.

Please see the Visual Micro document for more info. Here are two articles from the visulmicro.com documentation index

Adding libraries to your sketch: http://www.visualmicro.com/page/User-Guide.aspx?doc=Add-Libraries.html
Managing Libraries with Library Manager: http://www.visualmicro.com/page/User-Guide.aspx?doc=Library-Manager.html

After you add libraries to a sketch the code can be viewed easily using "vMicro>Toggle Hidden Files"

After installing a library use the Examples tab on the Micro Explorer to easily create a new cloned project of any example or create a new project and copy the code in manually like you did. The Examples tab gives both a way to clone or open an example and a way to view just the source code without creating a project

note

Most libraries can be compiled as project code. However Arduino recently started compiling all code found in the \src folder and below. So visual micro will shortly recommend moving the src\_micro-api to some other location. This is why arduino will appear to compile code in the \src folder but it compiles it as project code which isn't right. Another reason to stay away from the \src\_micro-api\ folder.

The vMicro>toggle hidden files creates shortcuts to to code instead of importing locally so is a safe way to see and explore the library sources without causing confusion in the arduino ide.

and thanks to you too for explaining.

Okay yes you are right you need local libraries.

There has been some huge changes in arduino over the past 6-9 months and things are only just now settling and maturing instead of changing.

Furthermore local libraries are relatively new but more importantly the deep search is a very new. I will test them more over the next few days now that some other jobs are complete.

To test/create a local library I suggest you create a new arduino project and then right click the project in the solution explorer and click "add>add code>new arduino library". That should #include the lib in the .ino and also create the physical files.

The .ino source should have #includes such as:-
#include <OneWire.h>
#include <MyLib.h>

I suggest you install the latest visual micro because there are some compiler cache fixes that will avoid a lot of confusion for someone who will be changing library sources. A release has just been uploaded.

There aren't usually so many updates but it's a busy time.