SiLA2.Utils
7.5.3
See the version list below for details.
dotnet add package SiLA2.Utils --version 7.5.3
NuGet\Install-Package SiLA2.Utils -Version 7.5.3
<PackageReference Include="SiLA2.Utils" Version="7.5.3" />
paket add SiLA2.Utils --version 7.5.3
#r "nuget: SiLA2.Utils, 7.5.3"
// Install SiLA2.Utils as a Cake Addin #addin nuget:?package=SiLA2.Utils&version=7.5.3 // Install SiLA2.Utils as a Cake Tool #tool nuget:?package=SiLA2.Utils&version=7.5.3
Introduction
.NET 7 implementation of the SiLA2 Standard (https://sila-standard.com/)
- Platform-independent
- SiLA2.Server even runs on embedded Linux Host as recommended AspNetCore-Process
- Feature-To-Proto-Generation by XSLT
- SiLA2 Core Features included in SiLA2.dll
- Additional Features should be part of Feature-Implementation Assemblies (just add your features and protos in MSBuild Targets ProtoPreparation & ProtoGeneration like it is done in Assemblies TemperatureController.Features.csproj or ShakerController.Features.csproj)
- Extensible InProcess Server Web Frontend included (based on Blazor (https://dotnet.microsoft.com/apps/aspnet/web-apps/blazor) which supports "server push" functionality)
- Optional InProcess-Database-Module (based on SQLite) with basic User Management which can be easily extended.
- Optional InProcess-Document-Database-Module (based on LiteDB) named SiLA2.Database.NoSQL which can be used as AnIML data storage...
- Optional Inter Process Communication Module (SiLA2.IPC.NetMQ) for Socket Communication...compatible with ZeroMQ (https://zeromq.org/)
- Optional AnIML Module offering the AnIML Domain Model as C# classes generated from official AnIML schemas (https://github.com/AnIML/schemas)
- Optional Component to manage Encryption and Certifcates
There´s also a Web Application SiLA2.UniversalClient.Net to control your running SiLA2.Servers in your local network.
If you want to see all the Modules and Components you should start SiLA2.Temperature.Server.App and afterwards SiLA2.Temperature.Server.App.Webfrontend. Running the Server the first time, you´ll have to add an exception to your browser once due to the self-signed certificate which was created by the Server if there´s none.
Prerequisites
- Linux / macOS
- You´ll need the .NET 7 SDK >> https://dotnet.microsoft.com/download/dotnet/7.0
- It´s not necessary to build applications with a GUI but if you do so an IDE like Visual Studio Code ( >> https://code.visualstudio.com/ ) would be convenient
- Windows
- Download free IDE Visual Studio 2022 Community ( >> https://visualstudio.microsoft.com/de/vs/community/ ), use commercial Visual Studio 2022 Version or Visual Studio Code as well
- .NET 7 SDK is included in Visual Studio 2022...if you want to use Visual Studio Code or other IDEs you´ll have to download it on your own (see link above)
Getting Started
- Clone Repo
- Please be sure fetching sila_base submodule by
- checking out the Repository with git-submodules recursively
- git clone --recurse-submodules https://gitlab.com/SiLA2/sila_csharp.git
- or check out the Repository and run following commands
- git submodule init
- git submodule update
- checking out the Repository with git-submodules recursively
- Please be sure fetching sila_base submodule by
- Run gRPC-Server
- SiLA2.Temperature.Server.Basic.App or
- SiLA2.Temperature.Server.App
- Run SiLA2.Temperature.Client.App connecting automatically to SilaServer or
- Run SiLA2.Temperature.Server.App.Webfrontend (in Debug-Mode https://localhost:5101) to open a SilaServer-WebFrontend
- In the SilaServer-WebFrontend you´ll find NavigationLink "User Management"-View to use SilaServer-Database. There´s also an example of how Server-Push-Feature can be used...just click on NavigationLink "Temperature" and hit button "Change Temperature"...the values you produced can be saved as AnIML data by pushing the according button...
Build your own Project based on official Nuget-Packages
- Created ASP.NET Core Application as SiLA2.Server Project
- Search for & reference SiLA2.* packages found at Nuget.org in Visual Studio or https://www.nuget.org/ ...use at least SiLA2.Core...
- Create *.sila.xml-Feature-File and include it like it was done in Example Project SiLA2.Referencing.Nuget.Features.csproj
- Implement the features you´ve defined in your *.sila.xml-Feature-File in your Feature-Assembly
- Reference your Feature-Assenbly in your SiLA2.Server Project
- Add MSBuild Targets ProtoPreparation & ProtoGeneration in your FeatureAssembly.csproj (like it is done in any of the ExampleFeature.csproj files)
- Create SilA2-Clients communicating with the SiLA2.Server...in this case you might want to use Nuget-Package SiLA2.Client...
Build and Test
- Just build Solution and run as described in "# Getting Started".
- Alternatively you could use the SiLA Universal Client (https://gitlab.com/SiLA2/universal-sila-client/sila_universal_client)...it´s still experimental and it could be possible that you have to register SiLA2 Servers manually by IP yet...
- If you have problems building the solution you might clean your Nuget-Cache by 'rmdir -r %UserProfile%.nuget\packages*' once...
Contribute
It´s Open Source (License >> MIT)...feel free to use or contribute. For Merge-Requests contact me by E-Mail >>> CPohl@inheco.com or Stefan Koch >>> koch@equicon.de
For Open Questions
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net7.0 is compatible. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
-
net7.0
- CommandLineParser (>= 2.9.1)
- Grpc.Net.Client (>= 2.55.0)
- IPNetwork2 (>= 2.6.598)
- Microsoft.Extensions.Configuration.Abstractions (>= 7.0.0)
- Microsoft.Extensions.Logging.Abstractions (>= 7.0.1)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 7.0.0)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on SiLA2.Utils:
Package | Downloads |
---|---|
SiLA2.Core
Basic .NET 8 Server Implementation of the SiLA2 Standard (https://sila-standard.com/). You´ll find examples how to use it @ https://gitlab.com/SiLA2/sila_csharp ... |
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
8.1.2 | 169 | 10/20/2024 |
8.1.1 | 333 | 8/31/2024 |
8.1.0 | 610 | 2/11/2024 |
8.0.0 | 727 | 11/15/2023 |
7.5.4 | 550 | 10/27/2023 |
7.5.3 | 641 | 7/19/2023 |
7.5.2 | 668 | 7/3/2023 |
7.5.1 | 392 | 6/2/2023 |
7.4.6 | 638 | 5/21/2023 |
7.4.5 | 459 | 5/7/2023 |
7.4.4 | 473 | 4/28/2023 |
7.4.3 | 740 | 3/29/2023 |
7.4.2 | 370 | 3/29/2023 |
7.4.1 | 389 | 3/29/2023 |
7.3.2 | 425 | 3/10/2023 |
7.3.1 | 696 | 1/22/2023 |
7.2.1 | 489 | 12/30/2022 |
7.1.3 | 430 | 12/29/2022 |
7.1.2 | 433 | 12/29/2022 |
7.1.1 | 458 | 12/27/2022 |
7.0.0 | 546 | 11/9/2022 |
6.4.1 | 878 | 11/7/2022 |
6.3.9 | 3,187 | 10/4/2022 |
6.3.8 | 724 | 10/4/2022 |
6.3.6 | 794 | 9/27/2022 |
6.3.5 | 2,126 | 9/6/2022 |
6.3.4 | 864 | 8/16/2022 |
6.3.3 | 858 | 8/16/2022 |
6.3.2 | 834 | 8/16/2022 |
6.3.1 | 834 | 8/12/2022 |
6.2.5 | 708 | 8/8/2022 |
6.2.3 | 909 | 8/2/2022 |
6.2.2 | 707 | 8/1/2022 |
6.2.1 | 703 | 7/31/2022 |
6.1.0 | 1,068 | 7/5/2022 |
6.0.6 | 2,397 | 1/29/2022 |
6.0.5 | 874 | 1/21/2022 |
6.0.3 | 418 | 1/9/2022 |
6.0.2 | 327 | 1/3/2022 |
6.0.0 | 368 | 12/8/2021 |