This package includes the CoreLibrary assembly for .NET nanoFramework C# projects. This package requires a target with mscorlib v100.22.0.3 (checksum 0x2DD1D4D8). In case you don't need the System.Reflection API there is another NuGet package without this API.
$ dotnet add package nanoFramework.CoreLibrary
| Component | Build Status | NuGet Package |
|---|---|---|
| Base Class Library |  | |
| Base Class Library w/o reflection |  |
The .NET nanoFramework Base Class Library is provided in two flavours: with or without support for System.Reflection namespace. The reason for this is that the reflection API adds up a significant size to the DLL and image size. For targets with smaller flash this can be prohibitive.
nanoFramework has a dedicated Unit Test framework. This repository has Unit Test and you will find all of them under the Tests folder. The main solution embed all all the tests as well. You can run them directly from Visual Studio and create new tests. For more information on the Unit Test Framework.
CoreLibrary has specific needs that differ from what you'll find in the documentation:
You can then run the test either on a real device, either in the emulator as described in the documentation. You may have to manually flash your device for the mscorlib version to match the one you are building on.
Important: Any new code checked in this repository will have to:
All the projects are referenced based and to be able to run the tests in the pipeline, in command line and in Visual Studio, it does require a specific structure:
NFUnitTestAdapter project must be present and untouched. It does contains the core elements needed to have the nanoCLR Win32 application present.nano.runsettings file in each sub directory you want to run the tests on from Visual StudioDeveloper Command Prompt for VS 2019 then you can use from the home cloned lib-CoreLibrary directory a command line like this one:vstest.console.exe .\Tests\NFUnitTestBitConverter\bin\Release\NFUnitTest.dll /Settings:.\Tests\NFUnitTestAdapater\nano.runsettings /TestAdapterPath:.\nanoFramework.TestFramework\source\TestAdapter\bin\Debug\net4.8 /Diag:.\log.txt /Logger:trxNotes:
For documentation, providing feedback, issues and finding out how to contribute please refer to the Home repo.
Join our Discord community here.
The list of contributors to this project can be found at CONTRIBUTORS.
The nanoFramework Class Libraries are licensed under the MIT license.
This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behaviour in our community. For more information see the .NET Foundation Code of Conduct.
This project is supported by the .NET Foundation.