Use classes and other managed types with Unity's C# Job System.
The Job System only accepts blittable struct types for jobs.
This package makes it easy to use managed types as jobs by providing blittable structs that reference managed objects using GCHandle and forward job execution to them.
- Easily schedule jobs implemented by class types, as well as struct types with managed fields
- Schedule managed
IJobtypes using ManagedJob - Schedule managed
IJobFortypes using ManagedJobFor - Schedule managed
IJobParallelFortypes using ManagedJobParallelFor - Schedule managed
IJobParallelForTransformtypes using ManagedJobParallelForTransform - Automatic disposal of the allocated
GCHandleif you callSchedule/Runmethods and their variations directly on the wrapper structs
- Managed jobs are not compatible with Burst
Either:
- Use the openupm registry and install this package using the openupm-cli:
openupm add com.gilzoide.managed-jobs - Install via Unity Package Manager using this repository URL and tag:
https://github.com/gilzoide/unity-managed-jobs.git#1.0.0 - Clone this repository directly inside your project's
AssetsorPackagesfolder.
using Unity.Jobs;
using Gilzoide.ManagedJobs;
// 1. Create your managed job type
public class MyManagedJobClass : IJob
{
public string Message = "Fields with managed types are supported!";
public void Execute()
{
Debug.Log($"Job is being executed! Here's the message: '{Message}'");
}
}
// 2. Schedule the job by using the wrapper ManagedJob struct type
var myManagedJobObject = new MyManagedJobClass();
var jobHandle = new ManagedJob(myManagedJobObject).Schedule();
// 3. Complete the jobHandle or use it as dependency to other jobs as usual
jobHandle.Complete();
// 4. Enjoy 🍾