FiftyOne.DeviceDetection
4.4.150
See the version list below for details.
dotnet add package FiftyOne.DeviceDetection --version 4.4.150
NuGet\Install-Package FiftyOne.DeviceDetection -Version 4.4.150
<PackageReference Include="FiftyOne.DeviceDetection" Version="4.4.150" />
paket add FiftyOne.DeviceDetection --version 4.4.150
#r "nuget: FiftyOne.DeviceDetection, 4.4.150"
// Install FiftyOne.DeviceDetection as a Cake Addin #addin nuget:?package=FiftyOne.DeviceDetection&version=4.4.150 // Install FiftyOne.DeviceDetection as a Cake Tool #tool nuget:?package=FiftyOne.DeviceDetection&version=4.4.150
51Degrees Device Detection Engines
Pipeline API
Introduction
This repository contains the device detection engines for the .NET implementation of the Pipeline API.
The specification is also available on GitHub and is recommended reading if you wish to understand the concepts and design of this API.
Dependencies
Visual Studio 2022 or later is recommended. Although Visual Studio Code can be used for working with most of the projects.
The core device detection projects are written in C and C++. The Pipeline engines are written in C# and target .NET Standard 2.0.3. Example and test projects mostly target .NET 6.0 though in some cases, projects are available targeting other frameworks.
For runtime dependencies, see our
dependencies
page. The ci/options.json
file lists the tested and packaged .NET versions
and operating systems automatic tests are performed with. The solution will
likely operate with other versions.
Data
The API can either use our cloud service to get its data or it can use a local (on-premise) copy of the data.
Cloud
You will require a resource key to use the Cloud API. You can create resource keys using our configurator, see our documentation on how to use this.
On-Premise
In order to perform device detection on-premise, you will need to use a 51Degrees data file. This repository includes a free, 'lite' file in the 'device-detection-data' sub-module that has a significantly reduced set of properties. To obtain a file with a more complete set of device properties see the 51Degrees website. If you want to use the lite file, you will need to install GitLFS.
On Linux:
sudo apt-get install git-lfs
git lfs install
Then, navigate to 'device-detection-cxx/device-detection-data' and execute:
git lfs pull
Solutions and projects
- FiftyOne.DeviceDetection - Device detection engines and related
projects.
- FiftyOne.DeviceDetection - Contains device detection engine builders.
- FiftyOne.DeviceDetection.Cloud - A .NET engine which retrieves device detection results by consuming the 51Degrees cloud service. This can be swapped out with either the hash or pattern engines seamlessly.
- FiftyOne.DeviceDetection.Hash.Engine.OnPremise - .NET implementation of the device detection hash engine. CMake is used to build the native binaries.
- FiftyOne.DeviceDetection.Shared - Shared classes used by the device detection engines.
Installation
Nuget
The easiest way to install is to use NuGet to add the reference to the package:
Install-Package FiftyOne.DeviceDetection
Build from Source
Device detection on-premise uses a native binary (i.e. compiled from C code to target a specific platform/architecture). The NuGet package contains several binaries for common platforms. However, in some cases, you'll need to build the native binaries yourself for your target platform. This section explains how to do this.
Pre-requisites
- Install C build tools:
- Windows:
- You will need either Visual Studio 2022 or the C++ Build
Tools
installed.
- Minimum platform toolset version is
v143
- Minimum Windows SDK version is
10.0.18362.0
- Minimum platform toolset version is
- You will need either Visual Studio 2022 or the C++ Build
Tools
installed.
- Linux/MacOS:
sudo apt-get install g++ make libatomic1
- Windows:
- If you have not already done so, pull the git submodules that contain the
native code:
git submodule update --init --recursive
Visual studio should now be able to build the native binaries as part of its normal build process.
Packaging
You can package a project into NuGet *.nupkg
file by running a command like:
dotnet pack [Project] -o "[PackagesFolder]" /p:PackageVersion=0.0.0 -c [Configuration] /p:Platform=[Architecture]
⚠️ Notes on packaging FiftyOne.DeviceDetection.Hash.Engine.OnPremise
📝 Using AnyCPU
might prevent the unmanaged (C++) code from being built into .Native.dll
library. Use x86
/x64
/arm64
specifically.
📝 If creating cross-platform package from multiple native dlls, put all 6x FiftyOne.DeviceDetection.Hash.Engine.OnPremise.Native.dll
into respective folders:
../
macos/
arm64/
x64/
linux/
x64/
x86/
windows/
x64/
x86/
and add to the packaging command:
/p:BuiltOnCI=true
related CI scripts:
BuiltOnCI
var:- [https://github.com/51Degrees/common-ci/blob/main/dotnet/build-project-core.ps1]
- [https://github.com/51Degrees/common-ci/blob/main/dotnet/build-package-nuget.ps1]
- [https://github.com/51Degrees/common-ci/blob/main/dotnet/build-project-framework.ps1]
- [https://github.com/51Degrees/device-detection-dotnet/blob/main/ci/run-performance-tests-console.ps1]
- Copying native binaries:
- [https://github.com/51Degrees/device-detection-dotnet/blob/main/ci/build-package.ps1]
Strong naming
We currently do not strong name assemblies due to downsides for developers. The main of which is that .NET Framework on Windows enables strict loading of assemblies once an assembly is strong named. A strong-named assembly reference must exactly match the version of the loaded assembly, forcing developers to configure binding redirects when using the assembly.
If it is absolutely critical for your use case to integrate a strong-named assembly - please create a feature request issue.
Examples
Examples can be found in device-detection-dotnet-examples repository.
Tests
Tests can be found in the Tests/
folder. These can all be run from within
Visual Studio or by using the dotnet test
command line tool.
Some tests require additional resources to run. These will either fail or return an 'inconclusive' result if these resources are not provided.
- Some tests require an 'Enterprise' data file. This can be obtained by
purchasing a license.
- Once available, the full path to this data file must be specified in the
DEVICEDETECTIONDATAFILE
environment variable.
- Once available, the full path to this data file must be specified in the
- Tests using the cloud service require resource keys with specific properties
to be provided using environment variables:
- The
SUPER_RESOURCE_KEY
environment variable should be populated with a key that includes all properties. A license is required in order to access some properties.
- The
Project documentation
For complete documentation on the Pipeline API and associated engines, see the 51Degrees documentation site.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. 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. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- FiftyOne.DeviceDetection.Cloud (>= 4.4.150)
- FiftyOne.DeviceDetection.Hash.Engine.OnPremise (>= 4.4.150)
- Microsoft.CSharp (>= 4.7.0)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on FiftyOne.DeviceDetection:
Package | Downloads |
---|---|
Foundation.SitecoreExtensions
Foundation.SitecoreExtensions |
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated | |
---|---|---|---|
4.4.165 | 122 | 8/15/2024 | |
4.4.164 | 96 | 8/14/2024 | |
4.4.163 | 114 | 8/13/2024 | |
4.4.162 | 247 | 8/7/2024 | |
4.4.161 | 122 | 8/6/2024 | |
4.4.160 | 73 | 8/5/2024 | |
4.4.159 | 67 | 8/3/2024 | |
4.4.158 | 97 | 7/30/2024 | |
4.4.157 | 147 | 7/26/2024 | |
4.4.156 | 49 | 7/26/2024 | |
4.4.155 | 164 | 7/24/2024 | |
4.4.154 | 241 | 7/19/2024 | |
4.4.153 | 120 | 7/18/2024 | |
4.4.152 | 115 | 7/17/2024 | |
4.4.151 | 106 | 7/16/2024 | |
4.4.150 | 99 | 7/15/2024 | |
4.4.149 | 205 | 7/11/2024 | |
4.4.148 | 132 | 7/10/2024 | |
4.4.147 | 123 | 7/9/2024 | |
4.4.146 | 153 | 7/7/2024 | |
4.4.145 | 194 | 7/4/2024 | |
4.4.144 | 347 | 6/27/2024 | |
4.4.143 | 140 | 6/25/2024 | |
4.4.142 | 623 | 6/19/2024 | |
4.4.141 | 147 | 6/19/2024 | |
4.4.140 | 200 | 6/15/2024 | |
4.4.139 | 185 | 6/11/2024 | |
4.4.138 | 634 | 6/1/2024 | |
4.4.137 | 135 | 5/31/2024 | |
4.4.136 | 178 | 5/29/2024 | |
4.4.135 | 95 | 5/29/2024 | |
4.4.134 | 642 | 5/25/2024 | |
4.4.133 | 206 | 5/22/2024 | |
4.4.132 | 208 | 5/18/2024 | |
4.4.131 | 107 | 5/17/2024 | |
4.4.130 | 108 | 5/16/2024 | |
4.4.129 | 73 | 5/16/2024 | |
4.4.128 | 92 | 5/15/2024 | |
4.4.127 | 83 | 5/15/2024 | |
4.4.126 | 153 | 5/14/2024 | |
4.4.125 | 254 | 5/13/2024 | |
4.4.124 | 126 | 5/12/2024 | |
4.4.123 | 85 | 5/12/2024 | |
4.4.122 | 262 | 5/8/2024 | |
4.4.121 | 266 | 5/3/2024 | |
4.4.120 | 63 | 5/2/2024 | |
4.4.119 | 136 | 4/30/2024 | |
4.4.118 | 256 | 4/28/2024 | |
4.4.117 | 178 | 4/25/2024 | |
4.4.116 | 230 | 4/23/2024 | |
4.4.115 | 192 | 4/21/2024 | |
4.4.114 | 161 | 4/20/2024 | |
4.4.113 | 4,622 | 4/10/2024 | |
4.4.112 | 133 | 4/4/2024 | |
4.4.111 | 501 | 3/27/2024 | |
4.4.110 | 1,103 | 3/21/2024 | |
4.4.109 | 161 | 3/21/2024 | |
4.4.108 | 209 | 3/19/2024 | |
4.4.107 | 165 | 3/18/2024 | |
4.4.106 | 162 | 3/17/2024 | |
4.4.105 | 155 | 3/16/2024 | |
4.4.104 | 1,046 | 2/22/2024 | |
4.4.103 | 240 | 2/21/2024 | |
4.4.102 | 310 | 2/16/2024 | |
4.4.101 | 236 | 2/15/2024 | |
4.4.100 | 263 | 2/14/2024 | |
4.4.99 | 219 | 2/14/2024 | |
4.4.98 | 527 | 2/2/2024 | |
4.4.97 | 254 | 2/1/2024 | |
4.4.96 | 1,302 | 1/28/2024 | |
4.4.95 | 234 | 1/27/2024 | |
4.4.94 | 252 | 1/26/2024 | |
4.4.93 | 630 | 1/18/2024 | |
4.4.92 | 271 | 1/16/2024 | |
4.4.91 | 289 | 1/14/2024 | |
4.4.90 | 256 | 1/13/2024 | |
4.4.89 | 238 | 1/12/2024 | |
4.4.88 | 260 | 1/11/2024 | |
4.4.87 | 245 | 1/10/2024 | |
4.4.86 | 366 | 1/7/2024 | |
4.4.85 | 1,055 | 12/21/2023 | |
4.4.84 | 258 | 12/19/2023 | |
4.4.83 | 494 | 12/8/2023 | |
4.4.82 | 334 | 12/3/2023 | |
4.4.81 | 282 | 12/1/2023 | |
4.4.80 | 269 | 11/30/2023 | |
4.4.79 | 292 | 11/29/2023 | |
4.4.78 | 299 | 11/26/2023 | |
4.4.77 | 257 | 11/25/2023 | |
4.4.76 | 289 | 11/24/2023 | |
4.4.75 | 272 | 11/23/2023 | |
4.4.74 | 294 | 11/21/2023 | |
4.4.73 | 517 | 11/4/2023 | |
4.4.72 | 242 | 11/3/2023 | |
4.4.71 | 258 | 11/2/2023 | |
4.4.70 | 232 | 11/1/2023 | |
4.4.69 | 355 | 10/29/2023 | |
4.4.68 | 261 | 10/28/2023 | |
4.4.67 | 255 | 10/27/2023 | |
4.4.66 | 263 | 10/26/2023 | |
4.4.65 | 290 | 10/25/2023 | |
4.4.64 | 1,798 | 10/12/2023 | |
4.4.63 | 403 | 10/6/2023 | |
4.4.62 | 804 | 9/24/2023 | |
4.4.61 | 317 | 9/21/2023 | |
4.4.60 | 245 | 9/21/2023 | |
4.4.59 | 479 | 9/17/2023 | |
4.4.58 | 256 | 9/16/2023 | |
4.4.57 | 285 | 9/15/2023 | |
4.4.56 | 291 | 9/14/2023 | |
4.4.55 | 279 | 9/13/2023 | |
4.4.54 | 386 | 9/11/2023 | |
4.4.53 | 282 | 9/10/2023 | |
4.4.52 | 268 | 9/9/2023 | |
4.4.51 | 345 | 9/6/2023 | |
4.4.50 | 315 | 9/3/2023 | |
4.4.49 | 302 | 9/1/2023 | |
4.4.48 | 336 | 8/31/2023 | |
4.4.47 | 511 | 8/18/2023 | |
4.4.46 | 439 | 8/11/2023 | |
4.4.45 | 339 | 8/10/2023 | |
4.4.44 | 303 | 8/8/2023 | |
4.4.43 | 7,122 | 7/22/2023 | |
4.4.42 | 314 | 7/20/2023 | |
4.4.41 | 330 | 7/17/2023 | |
4.4.40 | 273 | 7/15/2023 | |
4.4.39 | 338 | 7/13/2023 | |
4.4.38 | 376 | 7/9/2023 | |
4.4.37 | 337 | 7/6/2023 | |
4.4.36 | 323 | 7/4/2023 | |
4.4.35 | 372 | 6/28/2023 | |
4.4.34 | 305 | 6/27/2023 | |
4.4.33 | 964 | 6/24/2023 | |
4.4.32 | 619 | 6/22/2023 | |
4.4.31 | 977 | 6/21/2023 | |
4.4.30 | 337 | 6/20/2023 | |
4.4.29 | 393 | 6/15/2023 | |
4.4.28 | 311 | 6/14/2023 | |
4.4.27 | 348 | 6/12/2023 | |
4.4.26 | 308 | 6/10/2023 | |
4.4.25 | 396 | 6/8/2023 | |
4.4.24 | 1,746 | 6/5/2023 | |
4.4.23 | 15,572 | 3/24/2023 | |
4.4.22 | 1,555 | 3/20/2023 | |
4.4.21 | 593 | 3/15/2023 | |
4.4.20 | 433 | 3/10/2023 | |
4.4.19 | 609 | 3/6/2023 | |
4.4.17 | 3,330 | 2/15/2023 | |
4.4.16 | 4,024 | 2/1/2023 | |
4.4.15 | 697 | 1/18/2023 | |
4.4.14 | 1,450 | 12/8/2022 | |
4.4.13 | 1,307 | 12/7/2022 | |
4.4.12 | 1,734 | 11/2/2022 | |
4.4.11 | 765 | 8/30/2022 | |
4.4.10 | 1,551 | 8/10/2022 | |
4.4.9 | 820 | 7/27/2022 | |
4.4.8 | 189,320 | 6/29/2022 | |
4.4.7 | 597 | 6/22/2022 | |
4.4.6 | 576 | 6/15/2022 | |
4.4.5 | 573 | 5/25/2022 | |
4.4.3 | 829 | 5/4/2022 | |
4.4.2 | 572 | 4/27/2022 | |
4.4.1 | 585 | 4/20/2022 | |
4.4.0 | 604 | 4/7/2022 | |
4.3.17 | 1,308 | 3/31/2022 | |
4.3.16 | 1,298 | 3/2/2022 | |
4.3.15 | 3,058 | 2/2/2022 | |
4.3.14 | 895 | 1/25/2022 | |
4.3.13 | 13,503 | 12/22/2021 | |
4.3.12 | 598 | 12/15/2021 | |
4.3.11 | 567 | 12/1/2021 | |
4.3.10 | 571 | 11/17/2021 | |
4.3.9 | 957 | 11/3/2021 | |
4.3.8 | 705 | 10/6/2021 | |
4.3.6 | 872 | 9/15/2021 | |
4.3.5 | 183 | 9/1/2021 | |
4.3.4 | 685 | 8/17/2021 | |
4.3.3 | 220 | 8/3/2021 | |
4.3.0 | 526 | 6/16/2021 | |
4.2.4 | 2,210 | 5/11/2021 | |
4.2.1 | 1,513 | 2/3/2021 | |
4.2.0 | 707 | 1/6/2021 | |
4.1.10 | 1,760 | 8/10/2020 | |
4.1.8 | 323 | 7/13/2020 | |
4.1.7 | 557 | 6/30/2020 | |
4.1.6 | 1,894 | 5/29/2020 | |
4.1.0-beta.26 | 306 | 2/18/2020 | |
4.1.0-beta.25 | 231 | 2/13/2020 | |
4.1.0-beta.22 | 288 | 1/17/2020 | |
4.1.0-beta.19 | 275 | 1/7/2020 | |
4.1.0-beta.18 | 290 | 1/7/2020 |