Rails3レシピブック外伝
https://speakerdeck.com/u/a_matsuda/p/rails3-recipe-book-gaiden
118ページ Engineを使う
使いやすくなった Rails 3.1 の Engine
http://d.hatena.ne.jp/passingloop/20110801/p1
Rails Guides - Getting Started with Engines
http://guides.rubyonrails.org/engines.html
Extending Rails 3 with Railties
http://www.engineyard.com/blog/2010/extending-rails-3-with-railties/
日本語訳 http://www.engineyard.co.jp/blog/2013/extending-rails-3-with-railties/
#277 Mountable Engines
http://railscasts.com/episodes/277-mountable-engines
Crafting Rails Applications
Section 4.4 "Extending Rails with Railties"
Chapter 5 "Managing Application Events with Rails Engines"
WEB+DB Press vol.58
特集「詳解Rails3」

API Reference

Rails::Railtie

http://api.rubyonrails.org/classes/Rails/Railtie.html
日本語訳 http://blog.twiwt.org/e/e0445b

Railtie は Rails フレームワークのコアで、 Rails に機能を追加したり初期化プロセスを変更するためのいくつかのフックを提供します。

例えば、以下のような機能拡張を行う場合は Railtie が必要になります:

イニシャライザの作成

configuring a Rails framework for the application, like setting a generator

adding config.* keys to the environment

setting up a subscriber with ActiveSupport::Notifications

rake タスクの追加

Rails::Engine

Any Rails::Engine is also a Rails::Railtie, so the same methods (like rake_tasks and generators) and configuration options that are available in railties can also be used in engines.

RailtieとEngineの関係

Rails::Engine < Rails::Railtie

WEB+DB Press vol.58 特集「詳解Rails3」

Engine は Rack Application にもなっている。（Rails::Engine#call が存在する）
（Rackについては http://jp.rubyist.net/magazine/?0036-SinatraReintroduction#l10 など参照）

独自の config/routes.rb, config/locales/*, lib/tasks/* などを持ち、自動的にロードされる。

Railtie + アプリっぽい動作(?) = Engine

つかいかたの例

Railtie

あらゆるものがRailtieなので、何でもいいんだけど

ActiveRecord
rspec-rails
jquery-rails
haml-rails

module Haml
  module Rails
    class Railtie < ::Rails::Railtie
      config.generators.template_engine :haml

      config.before_initialize do
        Haml.init_rails(binding)
        Haml::Template.options[:format] = :html5
      end
    end
  end
end

configの設定とinitializeを行なっている。

Engine

Devise

その他

ActiveSupport.on_load

Railsの標準コンポーネントの拡張に便利。
http://api.rubyonrails.org/files/activesupport/lib/active_support/lazy_load_hooks_rb.html
http://blog.udzura.jp/2011/11/28/shibuya-rb-1st-with-activesupport-tips/
フックポイントは :action_controller, :action_view, :active_record, :action_mailer などが用意されている。

ActiveSupport::Concern

Rubyの既存クラスの拡張に便利。
http://api.rubyonrails.org/classes/ActiveSupport/Concern.html
http://guides.rubyonrails.org/plugins.html （記述が古い可能性あり）

今後 Sendagaya.rb でなにをやるか (10/15以降予定)

Engineの機能を知りたい
- API リファレンスを読もう
- ソースを読もう
- Kaminariのソースを読もう
- Crafting Rails Applications を読もう
Railtieの初期化、集約部分を知りたい
- ソースを読もう

Railtie, Engine 関係資料