xtd

xtd（发音为“extend”）是一个现代 C++17/20 框架，用于在 Microsoft Windows、Apple macOS、Linux、iOS 和 android (*) 上创建控制台、GUI（如 WinForms 形式）和单元测试应用程序。

(*) 有关详细信息，请参阅可移植性。

特征

免费且开源（MIT 许可证）；
原生 C++ 类库的集合，用于扩展std；
API 接近 .net API，采用现代 C++ 方法，并与 std 标准完全集成；
xtd 旨在以纯本机模式或 CSS 样式管理 GUI 控件和对话框。
使用高效、现代的 C++17/20 和 RAII 编程习惯编写；
高度便携，可在许多不同的平台上使用；
请参阅功能以获取更多信息。

xtd 库架构

建筑标志

xtd 由几个库组成。

xtd核心

xtd.core 库是现代 C++17/20 类、接口和值类型库，提供对系统功能的访问。它是构建 C++ 应用程序、组件和控件的基础。

xtd绘图

xtd.drawing 库包含支持基本 GDI+ 图形功能的类型。子命名空间支持高级二维和矢量图形功能、高级成像功能以及打印相关和排版服务。子命名空间还包含扩展设计时用户界面逻辑和绘图的类型。

xtd.表格

xtd.forms 库包含用于创建基于 Windows 的应用程序的类，这些应用程序充分利用 Microsoft Windows、Apple macOS 和 Linux 基本操作系统中提供的丰富用户界面功能。

xtd.tunit

图尼特 xtd.tunit 库是现代 C++17/20 的单元测试框架，受到 Microsoft.VisualStudio.TestTools.Cpp 的启发。

入门

安装提供下载、安装和卸载文档。
Guides 提供 xtd 指南和教程。
示例提供了 800 多个示例来帮助您使用 xtd，按库和主题分组。

发展现状

发行说明提供发行说明信息。
路线图提供了 xtd 路线图的视图。
看板为所有任务（增强、拉取请求、错误、问题……）提供看板视图。
开发状态提供有关类和库开发状态的信息。
翻译状态提供有关翻译状态的信息。

当前发布状态

该项目是一个开源项目。参与的开发人员利用自己的时间进行这些工作。因此很难确定实际日期。

但你可以跟踪发展的演变。我们保持最新状态。

持续集成构建状态

每次提交时，都会针对以下配置执行构建和单元测试：

操作系统	调试	发布
Windows (x64)
Windows (x86)
macOS
乌班图
iOS (**)
安卓（**）

(**) 仅 xtd.core 和 xtd.tunit。

部署到 GitHub 页面	地位
网站部署
最新部署参考指南

问题状态

由于 xtd 由看板项目管理，因此未决问题的数量可能非常大。下表更清晰地显示了未解决的错误/问题和增强功能的数量。

问题	打开	关闭
用户的错误/问题
xtd 0.1.0 - 增强/开发()*
xtd 0.1.1 - 增强/开发
xtd 0.2.0 - 增强/开发
xtd 0.3.0 - 增强/开发
xtd 0.4.0 - 增强/开发
xtd 1.0.0 - 增强/开发

(*) xtd 0.1.0 只有一项增强功能，因为项目管理尚不可用。

示例

经典的第一个应用程序“Hello World”。

控制台 (CLI)

你好世界控制台.cpp

# include < xtd/xtd >

using namespace xtd ;

auto main () -> int {
  console::background_color (console_color::blue);
  console::foreground_color (console_color::white);
  console::write_line ( " Hello, World! " );
}

或者简单地

# include < xtd/xtd >

using namespace xtd ;

auto main () -> int {
  console::out << background_color (console_color::blue) << foreground_color (console_color::white) << " Hello, World! " << environment::new_line;
}

CMakeLists.txt

 cmake_minimum_required ( VERSION 3.20)

project (hello_world_console)
find_package (xtd REQUIRED)
add_sources(hello_world_console.cpp)
target_type(CONSOLE_APPLICATION)

构建并运行

打开“命令提示符”或“终端”。导航到包含该项目的文件夹并键入以下内容：

xtdc run

输出

表单（GUI，如 WinForms）

hello_world_forms.cpp

# include < xtd/xtd >

using namespace xtd ::forms ;

class main_form : public form {
public:
  main_form () {
    text ( " Hello world (message_box) " );

    button1. location ({ 10 , 10 });
    button1. parent (* this );
    button1. text ( " &Click me " );
    button1. click += [] {
      message_box::show ( " Hello, World! " );
    };
  }
  
private:
  button button1;
};

auto main () -> int {
  application::run (main_form {});
}

或者简单地

# include < xtd/xtd >

auto main () -> int {
  auto main_form = xtd::forms::form::create ( " Hello world (message_box) " );
  auto button1 = xtd::forms::button::create (main_form, " &Click me " , { 10 , 10 });
  button1. click += [] { xtd::forms::message_box::show ( " Hello, World! " );};
  xtd::forms::application::run (main_form);
}

CMakeLists.txt

 cmake_minimum_required ( VERSION 3.20)

project (hello_world_forms)
find_package (xtd REQUIRED)
add_sources(hello_world_forms.cpp)
target_type(GUI_APPLICATION)

构建并运行

打开“命令提示符”或“终端”。导航到包含该项目的文件夹并键入以下内容：

xtdc run

输出

视窗

macOS

Linux 侏儒

tunit（单元测试，如 Microsoft 单元测试框架）

你好世界测试.cpp

# include < xtd/xtd >

using namespace xtd ;
using namespace xtd ::tunit ;

namespace unit_tests {
  class test_class_ (hello_world_test) {
    void test_method_ (create_string_from_literal) {
      auto s = string { " Hello, World! " };
      valid::are_equal ( 13 , s. size ());
      assert::are_equal ( " Hello, World! " , s);
    }
    
    void test_method_ (create_string_from_chars) {
      auto s = string { ' H ' , ' e ' , ' l ' , ' l ' , ' o ' , ' , ' , ' ' , ' W ' , ' o ' , ' r ' , ' l ' , ' d ' , ' ! ' };
      valid::are_equal ( 13 , s. size ());
      string_assert::starts_with ( " Hello, " , s);
      string_assert::ends_with ( " World! " , s);
    }
  };
}

auto main () -> int {
  return console_unit_test (). run ();
}

或没有帮手

# include < xtd/xtd >

using namespace xtd ;
using namespace xtd ::tunit ;

namespace unit_tests {
  class hello_world_test ;
  
  auto hello_world_test_class_attr = test_class_attribute { " unit_tests::hello_world_test " };
  class hello_world_test : public test_class {
    test_method_attribute create_string_from_literal_attr { " create_string_from_literal " , * this , &hello_world_test::create_string_from_literal};
    void create_string_from_literal () {
      auto s = string { " Hello, World! " };
      valid::are_equal ( 13 , s. size ());
      assert::are_equal ( " Hello, World! " , s);
    }
    
    test_method_attribute create_string_from_chars_attr { " create_string_from_chars " , * this , &hello_world_test::create_string_from_chars};
    void create_string_from_chars () {
      auto s = string { ' H ' , ' e ' , ' l ' , ' l ' , ' o ' , ' , ' , ' ' , ' W ' , ' o ' , ' r ' , ' l ' , ' d ' , ' ! ' };
      valid::are_equal ( 13 , s. size ());
      string_assert::starts_with ( " Hello, " , s);
      string_assert::ends_with ( " World! " , s);
    }
  };
}

auto main () -> int {
  return console_unit_test (). run ();
}

CMakeLists.txt

 cmake_minimum_required ( VERSION 3.20)

project (hello_world_test)
find_package (xtd REQUIRED)
add_sources(hello_world_test.cpp)
target_type(TEST_APPLICATION)