Missing assembly qualification

Oct 13, 2025 by wbrum.org 25 views

Introduction

When building a project in Release mode using the dotnet publish command, you may encounter the IL2122 warning. This warning is related to the sqlite-net-pcl library and the SQLitePCLRaw.batteries_v2 assembly. In this article, we will delve into the causes of this warning and explore possible solutions to resolve it.

Understanding the IL2122 Warning

The IL2122 warning is triggered when the dotnet publish command is used to build a project in Release mode. This warning is related to the SQLitePCLRaw.batteries_v2 assembly, which is a part of the sqlite-net-pcl library. The warning message indicates that the type SQLitePCLRaw.bundle_green.Resource is not assembly qualified.

What is Assembly Qualification?

Assembly qualification is a process that ensures that type names used for dynamically accessing a type are fully qualified with the assembly name. This is necessary to avoid conflicts between types with the same name but from different assemblies.

Why is Assembly Qualification Important?

Assembly qualification is crucial when working with dynamic type loading, such as in the case of the sqlite-net-pcl library. Without assembly qualification, the runtime may load the wrong type, leading to unexpected behavior or errors.

Causes of the IL2122 Warning

The IL2122 warning is typically caused by one of the following reasons:

Missing assembly qualification: The type name used for dynamic type loading is not fully qualified with the assembly name.
Incorrect assembly version: The assembly version used in the project does not match the version used in the sqlite-net-pcl library.
Conflicting type names: There are multiple types with the same name but from different assemblies, causing conflicts.

Resolving the IL2122 Warning

To resolve the IL2122 warning, you can try the following solutions:

1. Update the `sqlite-net-pcl` Library

Make sure that you are using the latest version of the sqlite-net-pcl library. You can update the library by running the following command in the NuGet Package Manager Console:

Install-Package sqlite-net-pcl -Version 1.8.1

2. Add Assembly Qualification

You can add assembly qualification to the type name used for dynamic type loading. For example:

var type = typeof(SQLitePCLRaw.bundle_green.Resource);

Should be changed to:

var type = typeof(SQLitePCLRaw.bundle_green.Resource, typeof(SQLitePCLRaw.batteries_v2));

3. Use the `AssemblyQualifiedName` Property

You can use the AssemblyQualifiedName property to get the fully qualified type name:

var type = typeof(SQLitePCLRaw.bundle_green.Resource);
var assemblyQualifiedName = type.AssemblyQualifiedName;

4. Use the `Type.GetType` Method

You can use the Type.GetType method to get the type instance with assembly qualification:

var type = Type.GetType("SQLitePCLRaw.bundle_green.Resource, SQLitePCLRaw.batteries_v2");

5. Ignore the IL2122 Warning

If none of the above solutions work, you can ignore the IL2122 warning by adding the following code to your project file:

<PropertyGroup>
  <WarningLevel>4</WarningLevel>
</PropertyGroup>

This will disable the IL2122 warning, but it is not recommended as it may lead to unexpected behavior or errors.

Conclusion

The IL2122 warning is a common issue when building a project in Release mode using the dotnet publish command. By understanding the causes of this warning and exploring possible solutions, you can resolve the issue and ensure that your project builds successfully.

Example Project

You can download the example project from the following link: test.zip

Additional Resources

For more information on the sqlite-net-pcl library and the IL2122 warning, you can refer to the following resources:

sqlite-net-pcl documentation
ILLink documentation
IL2122 warning documentation
IL2122 Warning Q&A: Frequently Asked Questions and Answers ====================================================================

Introduction

The IL2122 warning is a common issue when building a project in Release mode using the dotnet publish command. In this article, we will answer some of the most frequently asked questions related to the IL2122 warning.

Q1: What is the IL2122 warning?

A1: The IL2122 warning is a warning message that is triggered when the dotnet publish command is used to build a project in Release mode. This warning is related to the sqlite-net-pcl library and the SQLitePCLRaw.batteries_v2 assembly.

Q2: What causes the IL2122 warning?

A2: The IL2122 warning is typically caused by one of the following reasons:

Missing assembly qualification: The type name used for dynamic type loading is not fully qualified with the assembly name.
Incorrect assembly version: The assembly version used in the project does not match the version used in the sqlite-net-pcl library.
Conflicting type names: There are multiple types with the same name but from different assemblies, causing conflicts.

Q3: How can I resolve the IL2122 warning?

A3: To resolve the IL2122 warning, you can try the following solutions:

Update the sqlite-net-pcl library: Make sure that you are using the latest version of the sqlite-net-pcl library.
Add assembly qualification: Add assembly qualification to the type name used for dynamic type loading.
Use the AssemblyQualifiedName property: Use the AssemblyQualifiedName property to get the fully qualified type name.
Use the Type.GetType method: Use the Type.GetType method to get the type instance with assembly qualification.
Ignore the IL2122 warning: If none of the above solutions work, you can ignore the IL2122 warning by adding the following code to your project file.

Q4: What is assembly qualification?

A4: Assembly qualification is a process that ensures that type names used for dynamically accessing a type are fully qualified with the assembly name. This is necessary to avoid conflicts between types with the same name but from different assemblies.

Q5: Why is assembly qualification important?

A5: Assembly qualification is crucial when working with dynamic type loading, such as in the case of the sqlite-net-pcl library. Without assembly qualification, the runtime may load the wrong type, leading to unexpected behavior or errors.

Q6: Can I ignore the IL2122 warning?

A6: Yes, you can ignore the IL2122 warning by adding the following code to your project file:

<PropertyGroup>
  <WarningLevel>4</WarningLevel>
</PropertyGroup>

However, it is not recommended as it may lead to unexpected behavior or errors.

Q7: What are the consequences of ignoring the IL2122 warning?

A7: Ignoring the IL2122 warning may lead to unexpected behavior or errors. It is recommended to resolve the warning by updating the sqlite-net-pcl library, adding assembly qualification, or using the AssemblyQualifiedName property.

Q8: Can I use a different version of the `sqlite-net-pcl` library?

A8: Yes, you can use a different version of the sqlite-net-pcl library. However, make sure that the version you use is compatible with your project.

Q9: How can I check if the IL2122 warning is resolved?

A9: To check if the IL2122 warning is resolved, you can rebuild your project in Release mode using the dotnet publish command. If the warning is resolved, the warning message should not appear.

Q10: Where can I find more information on the IL2122 warning?

A10: For more information on the IL2122 warning, you can refer to the following resources: