A lightweight dependency injection framework for Unity using C# Source Generators.
- Lazy Loading: Dependencies are resolved only when first accessed
- Compile-time Generation: No runtime reflection overhead
- Simple API: Just add
[Inject]to your fields - Unity 6+ Compatible: Uses Roslyn Source Generators
- Open Window > Package Manager
- Click + > Add package from git URL
- Enter:
https://github.com/rhysomo/LazyInject.git
Add to your Packages/manifest.json:
{
"dependencies": {
"dev.insd.lazyinject": "https://github.com/rhysomo/LazyInject.git"
}
}
public class GameManager : MonoBehaviour
{
void Awake()
{
// Register singleton services
DIContainer.Global.Register<PlayerState>(new PlayerState());
DIContainer.Global.Register<ILogger>(new GameLogger());
// Register with key
DIContainer.Global.Register<ILogger>(new DebugLogger(), "debug");
}
}
public partial class PlayerController : MonoBehaviour
{
[Inject] private PlayerState _dPlayerState;
[Inject("debug")] private ILogger _dLogger;
void Start()
{
// Use generated properties (PascalCase of field name)
DPlayerState.Initialize();
DLogger.Log("Player initialized");
}
}
- Classes using
[Inject]must be declared aspartial - Access dependencies via generated Properties, not fields
- Field accessibility is preserved (private field → private property)
- Returns
nullif dependency is not registered (no exception thrown) - Recommended: Use
dprefix in field names (e.g.,_dPlayerState) to generateDPlayerStateproperty and avoid confusion with type names
For this field:
[Inject] private PlayerState _dPlayerState;
The Source Generator creates:
private PlayerState DPlayerState
{
get
{
if (_dPlayerState == null)
{
_dPlayerState = DIContainer.GetValue(typeof(PlayerState), "") as PlayerState;
}
return _dPlayerState;
}
}
| Code | Severity | Description |
|---|---|---|
| LDI001 | Error | Direct access to [Inject] field is not allowed. Use the generated property instead. |
| LDI002 | Warning | Generated property name matches type name. Consider using d prefix to avoid confusion. |
The Source Generator project is in the SourceGenerator~ folder (hidden from Unity).
./build.sh
This will build the DLL and copy it to the Plugins/ folder.
cd SourceGenerator~
dotnet build -c Release
cp bin/Release/netstandard2.0/Inject.CodeGen.dll ../Plugins/
MIT License