IgnoresAccessChecksToGenerator常见问题解决方案

IgnoresAccessChecksToGenerator常见问题解决方案

IgnoresAccessChecksToGenerator Generates reference assemblies where all the internal types & members become public, and applies the IgnoresAccessChecksTo attribute 项目地址: https://gitcode.com/gh_mirrors/ig/IgnoresAccessChecksToGenerator

项目基础介绍和主要编程语言

IgnoresAccessChecksToGenerator 是一个开源项目，该工具用于生成引用程序集（reference assemblies），这些引用程序集中所有内部类型和成员都会变成公开的，并且应用了 IgnoresAccessChecksTo 属性。该属性作用是允许一个程序集声明对其内部可见的其他程序集，相当于 InternalsVisibleToAttribute 的反面。该属性的类未在BCL（基础类库）中声明，但在CLR（公共语言运行时）中被识别（适用于桌面和Core平台）。当前没有编译器对该属性的支持（作者已经提交了PR到Roslyn），因此该项目可作为一个替代方案。

主要编程语言为C#，这是因为项目的代码文件和属性实现都是基于C#编写的。

新手使用该项目时需要特别注意的三个问题及解决步骤

问题一：如何正确添加 IgnoresAccessChecksToGenerator 包到项目中？

解决步骤:

1. 在项目的 csproj 文件中添加以下包引用：

   <Project Sdk="***.Sdk">
     <ItemGroup>
       <PackageReference Include="IgnoresAccessChecksToGenerator" Version="0.8.0" PrivateAssets="All" />
     </ItemGroup>
   </Project>
   

2. 确保 Project 标签中引入了正确的SDK版本。
3. 保存文件并运行 dotnet restore 来安装包。

问题二：如何使用 IgnoresAccessChecksTo 属性来声明对内部类型的访问？

解决步骤:

1. 在 csproj 文件的 <ItemGroup> 中定义需要访问的程序集：

   <IgnoresAccessChecksTo Include="AssemblyToGrantAccessTo" />
   

2. 如果需要排除特定的类型或命名空间，可以使用 <IgnoresAccessChecksToExcludeTypeName>：

   <IgnoresAccessChecksToExcludeTypeName Include="Namespace.TypeName" />
   

3. 完成修改后重新构建项目。

问题三：如果在使用过程中遇到权限问题怎么办？

解决步骤:

1. 确认添加的程序集名称（AssemblyToGrantAccessTo）是否正确无误。
2. 确保没有其他构建或安全设置阻止了对内部类型的访问。
3. 如果问题依旧存在，检查是否有其他中间件或安全插件干扰，或尝试清理项目缓存后重新构建。
4. 查阅官方文档或社区支持，看是否有人遇到过类似的问题及其解决方案。

通过以上步骤，新手开发者应该能够顺利开始使用 IgnoresAccessChecksToGenerator 项目，并解决在使用过程中遇到的常见问题。

IgnoresAccessChecksToGenerator Generates reference assemblies where all the internal types & members become public, and applies the IgnoresAccessChecksTo attribute 项目地址: https://gitcode.com/gh_mirrors/ig/IgnoresAccessChecksToGenerator