الانتقال إلى المحتوى
smallPict
الرئيسيةالتكاملات و SDKجوهرة Ruby & Rails (Gem)

معالجة الصور لـ Ruby on Rails وActiveStorage

سرّع رفع الصور في Rails باستخدام الـ gem الرسمي. يعمل جنبًا إلى جنب مع متغيرات 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
)

خطوات التكامل

  1. إضافة إلى Gemfile

    أضف السطر gem 'smallpict' إلى ملف Gemfile ثم شغّل bundle install.

  2. إعداد خدمة التخزين

    عرّف خدمة SmallPict في config/storage.yml باستخدام مفتاح API الخاص بك.

  3. تحديد النسخ المشتقة

    أعلن عن النسخ المحسنة في نماذجك وفق البنية المألوفة لـ ActiveStorage.

المزايا الرئيسية

  • يعمل مع ActiveStorage
  • جاهز للاستخدام مع معالجات المهام الخلفية مثل Sidekiq وGoodJob
  • يلغي الحاجة لتثبيت وصيانة حزم ImageMagick المعقدة على الخوادم
  • متوافق مع إصدارات Rails 6.x و7.x و8.x

هل تحتاج إلى إرشادات كاملة ومواصفات API؟

استكشف مراجع المعلمات وآليات المصادقة وإرشادات الاختبار المحلي في دليل مطوري جوهرة Ruby & Rails (Gem) الرسمي.

قراءة وثائق جوهرة Ruby & Rails (Gem)

سرّع مسار معالجة الصور في جوهرة Ruby & Rails (Gem)

جرّب تحسين صور AVIF و WebP في تطبيقك. بدون رسوم إعداد، ومع مفاتيح تجريبية فورية.