Chromely 开源项目使用教程

Chromely 开源项目使用教程

ChromelyBuild Cross Platform HTML Desktop Apps on .NET using native GUI, HTML5, JavaScript, CSS, Owin, AspNetCore (MVC, RazorPages, Blazor)项目地址:https://gitcode.com/gh_mirrors/ch/Chromely

1. 项目的目录结构及介绍

Chromely 项目的目录结构如下：

Chromely/
├── src/
│   ├── Chromely.Core/
│   ├── Chromely.CefGlue/
│   ├── Chromely.CefSharp/
│   ├── Chromely.Examples/
│   ├── Chromely.Mvc/
│   ├── Chromely.Winapi/
│   ├── Chromely.Shared/
│   └── Chromely.Shared.CefGlue/
├── tests/
│   ├── Chromely.Core.UnitTests/
│   ├── Chromely.Integration.Tests/
│   └── Chromely.Performance.Tests/
├── .gitignore
├── .gitattributes
├── Chromely.sln
├── README.md
└── LICENSE

目录结构介绍

• src/: 包含项目的所有源代码。
  • Chromely.Core/: 核心库，包含基本功能和接口。
  • Chromely.CefGlue/: 基于 CefGlue 的实现。
  • Chromely.CefSharp/: 基于 CefSharp 的实现。
  • Chromely.Examples/: 示例应用程序。
  • Chromely.Mvc/: 支持 MVC 模式的库。
  • Chromely.Winapi/: 用于 Windows API 的库。
  • Chromely.Shared/: 共享库。
  • Chromely.Shared.CefGlue/: 共享的 CefGlue 库。
• tests/: 包含项目的所有测试代码。
  • Chromely.Core.UnitTests/: 核心库的单元测试。
  • Chromely.Integration.Tests/: 集成测试。
  • Chromely.Performance.Tests/: 性能测试。
• .gitignore: Git 忽略文件。
• .gitattributes: Git 属性文件。
• Chromely.sln: Visual Studio 解决方案文件。
• README.md: 项目说明文档。
• LICENSE: 项目许可证。

2. 项目的启动文件介绍

Chromely 项目的启动文件通常位于 Chromely.Examples/ 目录下。以下是一个典型的启动文件示例：

using Chromely.Core;
using Chromely.Core.Configuration;
using Chromely.Core.Network;
using Chromely.CefGlue;

namespace Chromely.Examples
{
    class Program
    {
        static void Main(string[] args)
        {
            var config = DefaultConfiguration.Create();
            var app = new ChromelyCefGlueApp(config);
            app.Run(args);
        }
    }
}

启动文件介绍

• using 语句：引入必要的命名空间。
• Main 方法：程序的入口点。
  • DefaultConfiguration.Create(): 创建默认配置。
  • new ChromelyCefGlueApp(config): 创建 Chromely 应用程序实例。
  • app.Run(args): 运行应用程序。

3. 项目的配置文件介绍

Chromely 项目的配置文件通常是一个 JSON 文件，位于项目的根目录或 Chromely.Examples/ 目录下。以下是一个典型的配置文件示例：

{
  "appName": "Chromely Example",
  "startUrl": "local://dist/index.html",
  "windowOptions": {
    "title": "Chromely Example",
    "width": 1200,
    "height": 900,
    "resizable": true,
    "fullscreen": false,
    "maximize": false
  },
  "debuggingMode": true,
  "commandLineArgs": {
    "no-sandbox": true
  }
}

配置文件介绍

• appName: 应用程序的名称。
• startUrl: 启动时加载的 URL。
• windowOptions: 窗口选项。
  • title: 窗口标题。
  • width: 窗口宽度。
  • height: 窗口高度。
  • resizable: 窗口是否可调整大小。
  • fullscreen: 是否全

ChromelyBuild Cross Platform HTML Desktop Apps on .NET using native GUI, HTML5, JavaScript, CSS, Owin, AspNetCore (MVC, RazorPages, Blazor)项目地址:https://gitcode.com/gh_mirrors/ch/Chromely