Scarpe 开源项目最佳实践教程

1. 项目介绍

Scarpe 是一个基于 Ruby 语言的开源项目，它是对旧有的 Shoes 库的重新实现。Shoes 是一个允许开发者使用 Ruby 编写小型桌面应用程序的库。由于旧的 Shoes 库不再适用，Scarpe 旨在填补这一空白，并默认使用 Webview 作为其图形界面。

Scarpe 的目标是将 Ruby 程序转化为可运行的桌面应用程序，支持点击按钮、播放声音等功能。目前，Scarpe 仍在开发阶段，但已经有一些基础的功能实现。

2. 项目快速启动

要开始使用 Scarpe，首先确保你的系统安装了 Ruby 3.2 或更高版本。以下是在不同操作系统上安装和运行 Scarpe 的步骤：

安装依赖

Mac 版本

brew install portaudio pkg-config # 用于声音支持

Mac M1 版本

brew install portaudio && bundle config build.bloops --with-portaudio-dir=$(brew --prefix portaudio)

Ubuntu Linux 版本

sudo apt install libgtk-3-dev libwebkit2gtk-4.0-dev portaudio19-dev

对于其他 Linux 或 Windows 版本，请参考 Webview 文档。

克隆仓库并安装

git clone https://github.com/scarpe-team/scarpe.git
cd scarpe; bundle install

运行示例

./exe/scarpe examples/button.rb --dev

如果你使用 Visual Studio Code，可以使用提供的扩展来简化命令执行。

3. 应用案例和最佳实践

以下是一个简单的 "Hello World" 应用示例：

Shoes.app do
  para "Hello World"
end

另一个带按钮的示例：

Shoes.app do
  @push = button "Push me"
  @note = para "Nothing pushed so far"

  @push.click do
    @note.replace "Aha! Click! #{link('Go back') { @note.replace 'Nothing pushed so far' }}"
  end
end

在开发过程中，可以使用以下命令来运行测试：

bundle exec rake ci_test

或者运行单独的测试：

bundle exec rake lacci_test
bundle exec rake component_test
bundle exec rake test
bundle exec rake test:check_html_fixtures

4. 典型生态项目

Scarpe 的生态系统目前还在发展之中。以下是一些典型的生态项目：

• scarpe-components: 提供了额外的组件和功能，可以扩展 Scarpe 的能力。
• lacci: Scarpe 的一个子库，用于处理特定的 UI 元素。

Scarpe 项目的目标是支持和兼容更多的 Shoes 特性，并逐步完善其功能。开发者可以参与到项目中，添加新的特性或者修复 bugs，以推动项目的发展。