NewLife.Core

NewLife.Core - Core Library

🌐 简体中文 | 繁體中文 | Español | Deutsch | 日本語 | Français | Português | Русский | 한국어 | العربية

NewLife framework is a comprehensive .NET component ecosystem that provides high-performance infrastructure for building scalable applications. It offers essential capabilities such as logging, networking, serialization, caching, and multithreading, serving as the foundation for a range of applications from web services to IoT devices.

Core library tutorial: https://newlifex.com/core

Contents: Framework Overview · Why NewLife.Core · Quick Start · Main Features · Documentation Index · Repository layout · Build and test · NewLife Project Matrix · Contributing and feedback · License

Framework Overview

NewLife is composed of multiple component libraries, with NewLife.Core providing the foundation. The framework supports multiple target frameworks from net45 to net10.0 (.NET Framework 4.5 through .NET 10.0), thereby achieving broad compatibility across different environments.

NativeAOT: The core path is supported (measured in 31 scenarios + CI regression protection); dynamic capabilities such as plugins and scripting are not supported by design, see AOT Compatibility Analysis (中文) for the boundaries.

Why NewLife.Core

• One package for common infrastructure: logging, configuration, caching, networking, serialization, scheduling, object container and DI — a single reference is enough.
• Broad version coverage: 11 target frameworks in one package (net45 → net10.0, including Windows variants), the same API for legacy systems and new projects.
• NativeAOT ready: 31 core scenarios measured and guarded by a multi-RID CI smoke matrix; boundaries in AOT Compatibility Analysis.
• Restrained dependencies, permissive license: BCL and Microsoft compatibility packages only; MIT, so you can modify and rebrand (see License).

Quick Start

Install

dotnet add package NewLife.Core

Minimal example

using NewLife.Caching;
using NewLife.Log;

XTrace.UseConsole();                    // console log (also writes to file)
XTrace.WriteLine("Hello NewLife");

var cache = new MemoryCache();          // in-memory cache
cache.Set("key", "value", 60);          // expires in 60 seconds
var value = cache.Get<String>("key");   // read back

Template scaffolding

Run the following commands in a command line to quickly experience NewLife components:

dotnet new install NewLife.Templates
dotnet new nconsole --name test
cd test
dotnet run

Build and customize

The team has always maintained an open attitude: it not only supports opening the solution and compiling in VisualStudio (latest release), but is also compatible with dotnet build command-line compilation. The project files abandon complex features in pursuit of simplicity and ease of use, truly ready to use out of the box.

We publish the strong-name certificate newlife.snk to support compiling and replacing assemblies on your own.

NewLife components have been co-created by the community for more than 20 years and use the MIT open source license. Anyone can modify and redistribute them at will (no need to indicate the source)! Many enterprises build internal development frameworks based on this, and can even achieve private customization by batch-replacing all NewLife strings in the source code with their company name.

Documentation Index

Usage docs

• Core Library Contents (中文): Index of core component articles
• AOT Compatibility Analysis (中文): NativeAOT support scope, measured conclusions (smoke test 31/31), usage guidance, and known boundaries

Development docs

The repository's Doc/ directory maintains a capability documentation system (requirements definition → feature tracking → architecture design):

• Requirements (中文): Vision, core goals, and functional requirements
• Feature List (中文): Implementation/test/comment status tracking for all feature points
• Architecture Design (中文): Layering, module components, and key design decisions

Main Features

Basic Extensions (9)

Logging and Tracing (2)

Scheduling (3)

Configuration System (4)

Serialization (7)

Caching (7)

High-Performance Buffers (7)

Application Framework (16)

Security and Tokens (3)

Cloud Services (1)

Networking (15)

⚠️ Baidu Maps/AMap have been extracted into separate NuGet packages.

Repository layout

Build and test

dotnet build NewLife.Core/NewLife.Core.csproj -c Release
dotnet test XUnitTest.Core -c Release

• Full parallel run: run-tests.ps1 (multi-host parallel + timeout + trx summary)
• NativeAOT smoke: AotSmoke/, CI in .github/workflows/aot.yml
• Benchmarks: Benchmark/ (BenchmarkDotNet)

NewLife Project Matrix

All projects support net10.0/netstandard2.1/netstandard2.0/net462/net4.5 by default; older versions (2024.0801) support net4.0/net2.0

NewLife Development Team

The NewLife team (NewLife) was founded in 2002 and is an IoT industry solution provider for the new era, dedicated to providing software and hardware application solution consulting, system architecture planning, and development services. 5.23 million+ cumulative NuGet downloads. The team's core components (XCode / Redis / Stardust / AntJob / IoT, etc.) have been applied at scale in industries such as power, industry, transportation, environmental protection, healthcare, and cultural heritage.

We continue to improve, striving to become a long-term trusted .NET / IoT / distributed technology partner.

Website: https://newlifex.com Open source organization: https://github.com/NewLifeX
WeChat Official Account:

Contributing and feedback

• Before submitting, make sure dotnet build and the relevant unit tests pass; see the repository conventions for code style and commit messages.
• Report bugs and suggestions via Issue; Stars and PRs are welcome.
• See ChangeLog.md for release notes.

License

This project is licensed under MIT; the strong-name certificate newlife.snk is published so you can build and replace assemblies yourself.

If this project is helpful to you, welcome to Star it, share it with your team, or provide improvement suggestions via Issue/PR.