تكامل و SDK رسمي
تكامل مع ActiveStorage ومعالجة تلقائية في الخلفية عبر Sidekiq
جوهرة برمجية مخصصة لـ Ruby on Rails تتصل مباشرة بـ ActiveStorage لإنشاء نسخ WebP وAVIF المحسنة تلقائياً.
تثبيت:
حزمة RUBYgem 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
)خطوات التكامل
1إضافة إلى Gemfile
أضف السطر gem 'smallpict' إلى ملف Gemfile ثم شغّل bundle install.
2إعداد خدمة التخزين
عرّف خدمة SmallPict في config/storage.yml باستخدام مفتاح API الخاص بك.
3تحديد النسخ المشتقة
أعلن عن النسخ المحسنة في نماذجك وفق البنية المألوفة لـ ActiveStorage.
المزايا الرئيسية
- اتصال مباشر وشفاف مع نظام ActiveStorage في Rails
- جاهز للاستخدام مع معالجات المهام الخلفية مثل Sidekiq وGoodJob
- يلغي الحاجة لتثبيت وصيانة حزم ImageMagick المعقدة على الخوادم
- متوافق مع إصدارات Rails 6.x و7.x و8.x
وثائق المطورين الرسمية
هل تحتاج إلى إرشادات كاملة ومواصفات API؟
استكشف مراجع المعلمات وآليات المصادقة وإرشادات الاختبار المحلي في دليل مطوري جوهرة Ruby & Rails (Gem) الرسمي.
عزز أداء مسار صور جوهرة Ruby & Rails (Gem) الخاص بك
استمتع بتحسين صور AVIF و WebP بأقل من 50 مللي ثانية في تطبيقك. بدون رسوم إعداد ومفاتيح تجريبية فورية.