Rails Assets 项目使用教程

Rails Assets 项目使用教程

rails-assets The solution to assets management in Rails 项目地址: https://gitcode.com/gh_mirrors/ra/rails-assets

1. 项目介绍

Rails Assets 是一个用于管理 Rails 应用中静态资源的解决方案。它通过将 Bower 包转换为 Ruby Gem 的方式，简化了前端资源的管理流程。Rails Assets 允许开发者直接在 Rails 应用中使用 Bower 包，而无需手动处理前端资源的依赖关系。

项目状态

Bower 已经被弃用，因此新的项目不应再使用 Bower。由于 Rails Assets 是 Bower 和 Bundler 之间的代理，它也不应在新项目中使用。取而代之的是，现代 Rails 项目可以使用以下几种更好的解决方案：

• 使用 Hotwire 和 import maps 的默认路径。
• 使用流行的 JavaScript 打包工具的轻量级集成。
• 使用独立的 API 路径和前端仓库。

2. 项目快速启动

开发环境设置

1. 克隆项目：

   git clone git@github.com:tenex/rails-assets.git && cd rails-assets
   

2. 安装依赖：

   bundle install && npm install
   

3. 配置数据库和应用：

   cp config/database[.sample].yml config/database.yml
   cp config/application[.sample].yml config/application.yml
   

4. 编辑配置文件（如果需要）：

   # 编辑 config/database.yml 和 config/application.yml
   

5. 设置数据库：

   bin/rake db:setup
   

6. 启动应用：

   foreman start
   

无头 Chrome 测试

Rails Assets 使用 Capybara 进行无头 Chrome 测试。你需要安装 Chrome 和 Chrome Selenium WebDriver。

1. 安装 Chrome：

   cat << EOF > /etc/apt/sources.list.d/google-chrome.list
   deb [arch=amd64] http://dl.google.com/linux/chrome/deb/ stable main
   EOF
   wget -O- https://dl.google.com/linux/linux_signing_key.pub | gpg --dearmor > /etc/apt/trusted.gpg.d/google.gpg
   apt update && apt install -y google-chrome-stable
   

2. 安装 ChromeDriver：

   chrome_version="$(google-chrome --version | cut -d ' ' -f3)"
   wget "https://chromedriver.storage.googleapis.com/$chrome_version/chromedriver_linux64.zip" && unzip chromedriver_linux64.zip -d /usr/local/bin
   

将 Bower 包转换为 Ruby Gem

使用以下命令将 Bower 包转换为 Ruby Gem：

bin/rake 'component:convert[jquery,2.0.3]'

这将生成一个名为 rails-assets-NAME-VERSION.gem 的文件。你可以通过以下命令删除该组件：

bin/rake 'component:destroy[jquery,2.0.3]'

3. 应用案例和最佳实践

应用案例

Rails Assets 可以用于管理 Rails 应用中的前端资源，例如 jQuery、Bootstrap 等。通过将这些资源打包为 Ruby Gem，开发者可以更方便地在 Rails 应用中管理和使用这些资源。

最佳实践

• 避免在新项目中使用：由于 Bower 已被弃用，建议在新项目中使用现代的前端管理工具，如 Webpack、Vite 等。
• 使用现代解决方案：推荐使用 Hotwire 和 import maps 来管理前端资源，或者使用流行的 JavaScript 打包工具进行轻量级集成。

4. 典型生态项目

相关项目

• Hotwire：一个用于构建现代 Web 应用的 Rails 框架，支持实时更新和无刷新页面加载。
• Webpacker：Rails 官方推荐的 JavaScript 打包工具，支持现代前端开发流程。
• Import Maps：Rails 6.1 引入的新特性，允许开发者直接在 HTML 中引用 JavaScript 模块。

通过这些生态项目，开发者可以更高效地管理和使用前端资源，提升 Rails 应用的开发效率和用户体验。

rails-assets The solution to assets management in Rails 项目地址: https://gitcode.com/gh_mirrors/ra/rails-assets