面向 Ruby on Rails 与 ActiveStorage 的图片处理
使用官方 Gem 加速 Rails 图片上传。可与 ActiveStorage 变体和 Sidekiq 后台任务配合使用。
安装命令
RUBY 软件包
$ gem install smallpict-ruby代码接入示例
ruby
# Gemfile
gem 'smallpict-ruby'
# config/initializers/smallpict.rb
SmallPict.configure do |config|
config.api_key = ENV['SMALLPICT_API_KEY']
config.auto_format = :auto # Selects AVIF or WebP based on client
config.quality = 82
end
# In your Controller / Service:
optimized_url = SmallPict.optimize(
user.avatar.url,
width: 400,
format: :avif
)集成接入步骤
添加至 Gemfile
在 Gemfile 中添加 gem 'smallpict' 并运行 bundle install。
配置 Initializer
在 config/initializers/smallpict.rb 中配置 API 密钥和默认格式。
处理附件
在持久化到云存储前对 ActiveStorage 附件调用 smallpict_optimize。
核心优势与收益
- 支持 ActiveStorage
- 支持 Sidekiq 与 GoodJob 异步任务适配器
- 网络偶发抖动时的自动回退保护机制
- 在生成现代格式的同时完好保存原始原图
加速您的 Ruby & Rails Gem 图片处理流程
在您的应用中试用 AVIF 与 WebP 图片优化。无入网费,立即获取沙箱密钥。