如何使用C#在Android平台上基于.NET 6渲染OpenGL？

1. 如何引入Android特定代码 #

你可以基于**.NET for Android**（原Xamarin.Android，已整合进.NET 6+生态）创建独立的Android项目，将现有.NET 6渲染项目改为类库并引用，全程用C#实现Android外壳，无需编写Java代码：

• 新建.NET Android项目：选择"Android App (Xamarin)"模板（VS中已更名为.NET Android App），最低目标设为支持OpenGL ES 2.0的Android版本（API 16+）。
• 改造并引用现有项目：将你的.NET 6渲染项目改为类库项目（若之前是控制台/桌面应用），在Android项目中添加对该类库的引用。
• 实现C#版GLSurfaceView外壳：
  1. 自定义GLSurfaceViewRenderer类，继承自Android.Opengl.GLSurfaceView.Renderer，在GL线程中初始化上下文并绑定OpenTK调用：

     public class MyGLRenderer : GLSurfaceView.Renderer
     {
         private MyRenderingEngine _engine; // 你的现有渲染引擎实例
     
         public void OnSurfaceCreated(IGL10 gl, EGLConfig config)
         {
             OpenTK.Graphics.ES20.GL.LoadAll();
             _engine = new MyRenderingEngine();
             _engine.Initialize(); // 你的现有初始化逻辑
         }
     
         public void OnSurfaceChanged(IGL10 gl, int width, int height)
         {
             _engine.Resize(width, height); // 你的现有窗口大小调整逻辑
         }
     
         public void OnDrawFrame(IGL10 gl)
         {
             _engine.RenderFrame(); // 你的现有帧渲染逻辑
         }
     }
     

  2. 在MainActivity中创建GLSurfaceView并关联Renderer：

     [Activity(Label = "MyOpenTKApp", MainLauncher = true, ConfigurationChanges = ConfigChanges.Orientation | ConfigChanges.ScreenSize)]
     public class MainActivity : Activity
     {
         private GLSurfaceView _glView;
     
         protected override void OnCreate(Bundle savedInstanceState)
         {
             base.OnCreate(savedInstanceState);
             _glView = new GLSurfaceView(this);
             _glView.SetRenderer(new MyGLRenderer());
             _glView.RenderMode = GLSurfaceView.RenderMode.Continuous;
             SetContentView(_glView);
         }
     
         protected override void OnPause()
         {
             base.OnPause();
             _glView.OnPause();
         }
     
         protected override void OnResume()
         {
             base.OnResume();
             _glView.OnResume();
         }
     }
     

2. 构建流程的变化 #

• 多项目结构：解决方案将包含两个项目——原渲染类库和.NET Android应用，需分别针对桌面/Android目标构建。
• SDK依赖：需安装.NET Android SDK，可通过Visual Studio安装器或dotnet workload install android命令完成。
• 资源打包：将着色器、纹理等资源放入Android项目的Assets目录，构建时会自动打包进APK，需通过AssetManager读取。
• 清单配置：在AndroidManifest.xml中声明OpenGL ES版本和必要权限：

  <uses-feature android:glEsVersion="0x00020000" android:required="true" />
  <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
  

• 输出形式：构建Android项目会生成APK文件，可通过adb部署到设备/模拟器，或进行Google Play签名打包。

3. 现有代码的额外适配改动 #

除着色器兼容和文件保存逻辑外，还需调整以下内容：

• 输入坐标转换：Android触摸坐标原点在左上角，需转换为OpenGL左下角原点：

  float openGLY = _glView.Height - touchEvent.Y;
  

• 生命周期同步：渲染引擎需支持暂停/恢复逻辑，在Activity的OnPause/OnResume时停止/重启渲染循环，避免上下文丢失。
• 资源加载逻辑：将桌面端文件读取改为使用AndroidAssetManager加载Assets目录资源：

  var assetManager = Application.Context.Assets;
  using var stream = assetManager.Open("shaders/vertex.glsl");
  // 读取着色器内容
  

• 线程约束：确保所有OpenGL操作在GLSurfaceView的渲染线程执行，避免跨线程调用渲染API。
• 性能优化：针对Android设备内存限制，调整纹理分辨率、模型批处理策略；对低端设备可降低帧率或关闭非必要特效。
• 动态权限申请：若需访问外部存储、相机等敏感权限，需在运行时动态申请，不能仅依赖清单声明。

内容的提问来源于stack exchange，提问作者JeremyEastham