Active Storage Dashboard 项目的启动和配置教程

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

Active Storage Dashboard 是一个为 Rails 应用程序提供 Active Storage 数据监控的现代 UI 引擎。以下是项目的目录结构及其介绍：

• app/：包含 Rails 引擎的应用代码，如控制器、模型、视图等。
• bin/：存放可执行的脚本文件。
• config/：配置文件和初始izers。
• lib/：库文件，包括 Active Storage Dashboard 的核心功能。
• screenshots/：存放项目截图。
• test/：测试代码，包括单元测试和集成测试。
• .gitignore：指定 Git 忽略的文件和目录。
• .rubocop.yml：配置 RuboCop linter 的规则。
• Gemfile：项目依赖的 Gem 清单。
• Gemfile.lock：Gem 依赖的锁定文件，保证依赖的一致性。
• LICENSE.md：项目的许可证文件。
• README.md：项目的自述文件，包含项目信息和安装指南。
• Rakefile：Rake 任务定义。
• active_storage_dashboard.gemspec：定义 Active Storage Dashboard Gem 的元数据和依赖。

2. 项目的启动文件介绍

config/routes.rb 是项目的路由配置文件，用于定义如何将 HTTP 请求映射到 Rails 控制器的动作。

# config/routes.rb
Rails.application.routes.draw do
  # 定义 Active Storage Dashboard 的路由
  mount ActiveStorageDashboard::Engine, at: "/active-storage-dashboard"
end

将上述代码添加到你的 Rails 应用的 config/routes.rb 文件中，然后在浏览器中访问 /active-storage-dashboard，即可看到 Active Storage Dashboard 的界面。

3. 项目的配置文件介绍

项目的配置主要集中在 config/ 目录下的文件中。

• config/application.rb：Rails 应用的主配置文件，定义了应用的名称、环境等。
• config/environments/development.rb、config/environments/test.rb、config/environments/production.rb：分别为开发、测试和生产环境提供的配置。
• config/initializers/active_storage_dashboard.rb（如果存在）：专门用于配置 Active Storage Dashboard 的初始化文件。

例如，你可以在 config/initializers/active_storage_dashboard.rb 中添加自定义的配置：

# config/initializers/active_storage_dashboard.rb
ActiveStorageDashboard.configure do |config|
  # 自定义配置
end

确保在启动 Rails 应用前完成上述配置，以便正确地加载和运行 Active Storage Dashboard。