开源项目 Quarrel 使用教程

开源项目 Quarrel 使用教程

QuarrelQuarrel is a Discord client for Windows and Xbox that aims to bring voice chat to Xbox and improved support for varying screen sizes on devices running windows.项目地址:https://gitcode.com/gh_mirrors/qu/Quarrel

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

Quarrel 项目的目录结构如下：

Quarrel/
├── Assets/
├── Build/
├── Docs/
├── Quarrel.sln
├── README.md
├── Source/
│   ├── Quarrel/
│   │   ├── App.xaml
│   │   ├── App.xaml.cs
│   │   ├── MainPage.xaml
│   │   ├── MainPage.xaml.cs
│   │   ├── Models/
│   │   ├── Services/
│   │   ├── ViewModels/
│   │   ├── Views/
│   │   └── ...
│   ├── Quarrel.Controls/
│   ├── Quarrel.Markdown/
│   ├── Quarrel.Rest/
│   ├── Quarrel.Services/
│   └── ...
└── ...

目录结构介绍

• Assets/: 存放项目所需的静态资源文件，如图片、图标等。
• Build/: 存放编译生成的文件和构建脚本。
• Docs/: 存放项目的文档文件。
• Quarrel.sln: 项目的解决方案文件，用于在 Visual Studio 中打开项目。
• README.md: 项目的说明文档。
• Source/: 项目的源代码目录。
  • Quarrel/: 主项目目录，包含应用程序的主要代码。
    • App.xaml 和 App.xaml.cs: 应用程序的入口文件。
    • MainPage.xaml 和 MainPage.xaml.cs: 应用程序的主页面。
    • Models/: 存放数据模型类。
    • Services/: 存放服务类，如网络请求服务、数据存储服务等。
    • ViewModels/: 存放视图模型类，用于处理页面逻辑。
    • Views/: 存放页面视图文件。
  • Quarrel.Controls/: 自定义控件库。
  • Quarrel.Markdown/: Markdown 解析库。
  • Quarrel.Rest/: RESTful API 请求库。
  • Quarrel.Services/: 服务库，提供各种服务支持。

2. 项目的启动文件介绍

Quarrel 项目的启动文件是 App.xaml 和 App.xaml.cs。

App.xaml

App.xaml 文件定义了应用程序的资源字典和启动行为。示例如下：

<Application
    x:Class="Quarrel.App"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:local="using:Quarrel">
    <Application.Resources>
        <ResourceDictionary>
            <ResourceDictionary.MergedDictionaries>
                <!-- 合并其他资源字典 -->
            </ResourceDictionary.MergedDictionaries>
            <!-- 定义应用程序资源 -->
        </ResourceDictionary>
    </Application.Resources>
</Application>

App.xaml.cs

App.xaml.cs 文件包含了应用程序的初始化逻辑和启动代码。示例如下：

namespace Quarrel
{
    sealed partial class App : Application
    {
        public App()
        {
            this.InitializeComponent();
            this.Suspending += OnSuspending;
        }

        protected override void OnLaunched(LaunchActivatedEventArgs e)
        {
            Frame rootFrame = Window.Current.Content as Frame;

            if (rootFrame == null)
            {
                rootFrame = new Frame();
                rootFrame.NavigationFailed += OnNavigationFailed;

                if (e.PreviousExecutionState == ApplicationExecutionState.Terminated)
                {
                    // 从终止状态恢复
                }

                Window.Current.Content = rootFrame;
            }

            if (e.PrelaunchActivated == false)
            {
                if (rootFrame.Content == null)
                {
                    rootFrame.Navigate(typeof(MainPage), e.Arguments);
                }
                Window.Current.Activate();
            }
        }

        void OnNavigationFailed(object sender, NavigationFailedEventArgs e)
        {

QuarrelQuarrel is a Discord client for Windows and Xbox that aims to bring voice chat to Xbox and improved support for varying screen sizes on devices running windows.项目地址:https://gitcode.com/gh_mirrors/qu/Quarrel