jpmobile 5.0.0 → 5.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: d5f668491cdbb74dbda3097c3f29cdca5ca96914
-  data.tar.gz: 1f7e1e706fceb0454845f96dfe2fe01608b17321
+  metadata.gz: 0a59b2d91b6623e62be44818ffad569c1a30bb3f
+  data.tar.gz: a4737c7bfa0e802747202254c43162022213c3c0
 SHA512:
-  metadata.gz: 40b8a4b05cb91e7048c288fd8d2e8dbe4a37dd4f2249cfe4695b9393492dd2db8dae05e9ca18d86791b0640e910b9771340dc2e2bf7edafcee7c80e4ce3b9318
-  data.tar.gz: 29994a9633e0c2a97a69e1f06b7edf633623ee8b395eb633a3fd9dbceeda77bf81b20212615f7c35b718d357641ff3fec352f95c9e0378e301c24ba6aacf981c
+  metadata.gz: 478a46e5f1d336ad58d7cf51605cd51fe11c5e5159b507e7c602d054d2bd953d1939b713b130bae46a5f1425afd921470dcf37e133042d149269a2ec7d614776
+  data.tar.gz: 40699b70bfb7eeefc58dc071effa2abcafae6484ab0a59adb0f84e793313a8e15e63ef5e24b9ce6d861415f97bbda074ae908ad69e465968e4d2e3a0a100b870

data/.gitignore

@@ -2,8 +2,6 @@ doc
 tmp
 pkg
 .bundle
-Gemfile
-Gemfile.lock
 vendor
 *.gem
 *.rbc
@@ -17,4 +15,5 @@ rdoc
 spec/reports
 test/tmp
 test/version_tmp
-.ruby-version
+.ruby-version
+.envrc

data/.rubocop.yml

@@ -0,0 +1,123 @@
+inherit_gem:
+  onkcop:
+    - "config/rubocop.yml"
+    # uncomment if use rails cops
+    # - "config/rails.yml"
+    # uncomment if use rspec cops
+    # - "config/rspec.yml"
+
+AllCops:
+  TargetRubyVersion: 2.3
+  Exclude:
+    - 'bin/bundle'
+    - 'bin/rails'
+    - 'bin/rake'
+    - 'db/schema.rb'
+    - 'vendor/bundle/**/*'
+    - 'tools/**/*'
+    - 'test/rails/rails_root/**/*'
+    - 'vendor/jpmobile-*/**/*'
+
+Style/StringLiterals:
+  EnforcedStyle: single_quotes
+
+Style/Semicolon:
+  AllowAsExpressionSeparator: true
+
+Style/BlockDelimiters:
+  FunctionalMethods:
+    - before
+    - let
+    - let!
+    - subject
+    - watch
+    - expect
+  Exclude:
+    # For support original style
+    - 'lib/jpmobile/resolver.rb'
+    - 'lib/jpmobile/mail.rb'
+  EnforcedStyle: braces_for_chaining
+
+Style/IndentationConsistency:
+  EnforcedStyle: normal
+
+Style/AccessorMethodName:
+  Exclude:
+    - 'lib/jpmobile/mail.rb'
+
+Style/BlockComments:
+  Exclude:
+    - 'test/rails/overrides/spec/spec_helper.rb'
+
+Metrics/AbcSize:
+  Exclude:
+    - 'lib/jpmobile/datum_conv.rb'
+    - 'lib/jpmobile/emoticon.rb'
+    - 'lib/jpmobile/helpers.rb'
+    - 'lib/jpmobile/mail.rb'
+    - 'lib/jpmobile/mobile/*'
+    - 'lib/jpmobile/fallback_view_selector.rb'
+    - 'lib/jpmobile/resolver.rb'
+    - 'lib/jpmobile/rack/filter.rb'
+
+Metrics/CyclomaticComplexity:
+  Exclude:
+    - 'lib/jpmobile/emoticon.rb'
+    - 'lib/jpmobile/helpers.rb'
+    - 'lib/jpmobile/mail.rb'
+    - 'lib/jpmobile/mobile/au.rb'
+    - 'lib/jpmobile/mobile/docomo.rb'
+
+Metrics/PerceivedComplexity:
+  Exclude:
+    - 'lib/jpmobile/emoticon.rb'
+    - 'lib/jpmobile/helpers.rb'
+    - 'lib/jpmobile/mail.rb'
+    - 'lib/jpmobile/mobile/au.rb'
+    - 'lib/jpmobile/mobile/docomo.rb'
+    - 'lib/jpmobile/trans_sid.rb'
+
+Metrics/LineLength:
+  Exclude:
+    - '**/*_spec.rb'
+    - 'lib/jpmobile/emoticon/z_combine.rb'
+    - 'lib/jpmobile/hook_action_view.rb'
+    - 'lib/jpmobile/mobile/au.rb'
+    - 'lib/jpmobile/mobile/emobile.rb'
+
+Metrics/ModuleLength:
+  Exclude:
+    - 'lib/jpmobile/emoticon.rb'
+    - 'lib/jpmobile/helpers.rb'
+    - 'lib/jpmobile/util.rb'
+
+Metrics/BlockLength:
+  Exclude:
+    - '**/*_spec.rb'
+    - 'lib/jpmobile/emoticon.rb'
+    - 'lib/tasks/jpmobile_tasks.rake'
+    - 'test/rails/overrides/config/routes.rb'
+
+Metrics/BlockNesting:
+  Exclude:
+    - 'lib/jpmobile/trans_sid.rb'
+
+Metrics/ClassLength:
+  Exclude:
+    - 'lib/jpmobile/filter.rb'
+    - 'lib/jpmobile/mail.rb'
+    - 'lib/jpmobile/mobile/abstract_mobile.rb'
+    - 'lib/jpmobile/mobile/docomo.rb'
+
+Metrics/MethodLength:
+  Exclude:
+    - 'lib/jpmobile/emoticon.rb'
+    - 'lib/jpmobile/helpers.rb'
+    - 'lib/jpmobile/mail.rb'
+    - 'lib/jpmobile/resolver.rb'
+
+Lint/HandleExceptions:
+  Exclude:
+    - 'lib/jpmobile/emoticon.rb'
+    - 'lib/jpmobile/fallback_view_selector.rb'
+    - 'lib/jpmobile/position.rb'

data/CONTRIBUTING.md

@@ -10,19 +10,21 @@ $ git clone git@github.com:jpmobile/jpmobile-ipaddresses.git
 $ git clone git@github.com:jpmobile/jpmobile-terminfo.git
 ```
 
+## SMTPサーバの準備
+SMTP通信を行うテストが含まれており、現時点では[mailtrap](https://mailtrap.io/)を利用しています。
+
+以下のように環境変数を設定してテストを実行してください。
+
+```
+export MAILTRAP_USERNAME=XXXXXXXXXXXXXX
+export MAILTRAP_PASSWORD=YYYYYYYYYYYYYY
+```
+
 ## テスト
-テストにはSMTP通信を行うものも含まれるため、
-[koseki-mocksmtpd](https://github.com/koseki/mocksmtpd)などの、
-smtpdのmockを利用する必要があります。
+以下のテストを通過する必要があります。
+
 
-### 必要なgemパッケージ
-テストを実行するためには以下のgemパッケージが必要です。
-* rails (include rack)
-* sqlite3
-* nokogiri
-* rspec
-* rspec-rails
-* rspec-fixture
-* rack-test
-* mocha
-* geokit
+```
+$ bundle exec rake test
+$ bundle exec rubocop
+```

data/Gemfile

@@ -0,0 +1,6 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in jpmobile.gemspec
+gemspec
+
+gem 'onkcop', require: false

data/Gemfile.lock

@@ -0,0 +1,198 @@
+PATH
+  remote: .
+  specs:
+    jpmobile (5.0.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    actioncable (5.0.3)
+      actionpack (= 5.0.3)
+      nio4r (>= 1.2, < 3.0)
+      websocket-driver (~> 0.6.1)
+    actionmailer (5.0.3)
+      actionpack (= 5.0.3)
+      actionview (= 5.0.3)
+      activejob (= 5.0.3)
+      mail (~> 2.5, >= 2.5.4)
+      rails-dom-testing (~> 2.0)
+    actionpack (5.0.3)
+      actionview (= 5.0.3)
+      activesupport (= 5.0.3)
+      rack (~> 2.0)
+      rack-test (~> 0.6.3)
+      rails-dom-testing (~> 2.0)
+      rails-html-sanitizer (~> 1.0, >= 1.0.2)
+    actionview (5.0.3)
+      activesupport (= 5.0.3)
+      builder (~> 3.1)
+      erubis (~> 2.7.0)
+      rails-dom-testing (~> 2.0)
+      rails-html-sanitizer (~> 1.0, >= 1.0.3)
+    activejob (5.0.3)
+      activesupport (= 5.0.3)
+      globalid (>= 0.3.6)
+    activemodel (5.0.3)
+      activesupport (= 5.0.3)
+    activerecord (5.0.3)
+      activemodel (= 5.0.3)
+      activesupport (= 5.0.3)
+      arel (~> 7.0)
+    activesupport (5.0.3)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (~> 0.7)
+      minitest (~> 5.1)
+      tzinfo (~> 1.1)
+    addressable (2.5.1)
+      public_suffix (~> 2.0, >= 2.0.2)
+    arel (7.1.4)
+    ast (2.3.0)
+    builder (3.2.3)
+    capybara (2.13.0)
+      addressable
+      mime-types (>= 1.16)
+      nokogiri (>= 1.3.3)
+      rack (>= 1.0.0)
+      rack-test (>= 0.5.4)
+      xpath (~> 2.0)
+    capybara-webkit (1.14.0)
+      capybara (>= 2.3.0, < 2.14.0)
+      json
+    coderay (1.1.1)
+    concurrent-ruby (1.0.5)
+    diff-lcs (1.3)
+    erubis (2.7.0)
+    geokit (1.11.0)
+    git (1.3.0)
+    globalid (0.4.0)
+      activesupport (>= 4.2.0)
+    hpricot (0.8.6)
+    i18n (0.8.1)
+    json (2.1.0)
+    loofah (2.0.3)
+      nokogiri (>= 1.5.9)
+    mail (2.6.5)
+      mime-types (>= 1.16, < 4)
+    method_source (0.8.2)
+    mime-types (3.1)
+      mime-types-data (~> 3.2015)
+    mime-types-data (3.2016.0521)
+    mini_portile2 (2.1.0)
+    minitest (5.10.2)
+    nio4r (2.0.0)
+    nokogiri (1.7.2)
+      mini_portile2 (~> 2.1.0)
+    onkcop (0.48.1.1)
+      rubocop (~> 0.48.1)
+      rubocop-rspec (>= 1.15.0)
+    parser (2.4.0.0)
+      ast (~> 2.2)
+    powerpack (0.1.1)
+    pry (0.10.4)
+      coderay (~> 1.1.0)
+      method_source (~> 0.8.1)
+      slop (~> 3.4)
+    public_suffix (2.0.5)
+    rack (2.0.2)
+    rack-test (0.6.3)
+      rack (>= 1.0)
+    rails (5.0.3)
+      actioncable (= 5.0.3)
+      actionmailer (= 5.0.3)
+      actionpack (= 5.0.3)
+      actionview (= 5.0.3)
+      activejob (= 5.0.3)
+      activemodel (= 5.0.3)
+      activerecord (= 5.0.3)
+      activesupport (= 5.0.3)
+      bundler (>= 1.3.0, < 2.0)
+      railties (= 5.0.3)
+      sprockets-rails (>= 2.0.0)
+    rails-dom-testing (2.0.3)
+      activesupport (>= 4.2.0)
+      nokogiri (>= 1.6)
+    rails-html-sanitizer (1.0.3)
+      loofah (~> 2.0)
+    railties (5.0.3)
+      actionpack (= 5.0.3)
+      activesupport (= 5.0.3)
+      method_source
+      rake (>= 0.8.7)
+      thor (>= 0.18.1, < 2.0)
+    rainbow (2.2.2)
+      rake
+    rake (12.0.0)
+    rspec (3.6.0)
+      rspec-core (~> 3.6.0)
+      rspec-expectations (~> 3.6.0)
+      rspec-mocks (~> 3.6.0)
+    rspec-core (3.6.0)
+      rspec-support (~> 3.6.0)
+    rspec-expectations (3.6.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.6.0)
+    rspec-its (1.2.0)
+      rspec-core (>= 3.0.0)
+      rspec-expectations (>= 3.0.0)
+    rspec-mocks (3.6.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.6.0)
+    rspec-rails (3.6.0)
+      actionpack (>= 3.0)
+      activesupport (>= 3.0)
+      railties (>= 3.0)
+      rspec-core (~> 3.6.0)
+      rspec-expectations (~> 3.6.0)
+      rspec-mocks (~> 3.6.0)
+      rspec-support (~> 3.6.0)
+    rspec-support (3.6.0)
+    rubocop (0.48.1)
+      parser (>= 2.3.3.1, < 3.0)
+      powerpack (~> 0.1)
+      rainbow (>= 1.99.1, < 3.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (~> 1.0, >= 1.0.1)
+    rubocop-rspec (1.15.1)
+      rubocop (>= 0.42.0)
+    ruby-progressbar (1.8.1)
+    slop (3.6.0)
+    sprockets (3.7.1)
+      concurrent-ruby (~> 1.0)
+      rack (> 1, < 3)
+    sprockets-rails (3.2.0)
+      actionpack (>= 4.0)
+      activesupport (>= 4.0)
+      sprockets (>= 3.0.0)
+    sqlite3 (1.3.13)
+    sqlite3-ruby (1.3.3)
+      sqlite3 (>= 1.3.3)
+    thor (0.19.4)
+    thread_safe (0.3.6)
+    tzinfo (1.2.3)
+      thread_safe (~> 0.1)
+    unicode-display_width (1.2.1)
+    websocket-driver (0.6.5)
+      websocket-extensions (>= 0.1.0)
+    websocket-extensions (0.1.2)
+    xpath (2.0.0)
+      nokogiri (~> 1.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  capybara-webkit
+  geokit
+  git
+  hpricot
+  jpmobile!
+  onkcop
+  pry
+  rails (~> 5.0.0)
+  rspec
+  rspec-its
+  rspec-rails
+  sqlite3-ruby
+
+BUNDLED WITH
+   1.14.6

data/README.md

@@ -0,0 +1,409 @@
+[![CircleCI](https://circleci.com/gh/jpmobile/jpmobile/tree/master.svg?style=svg)](https://circleci.com/gh/jpmobile/jpmobile/tree/master)
+[![Code Climate](https://codeclimate.com/github/jpmobile/jpmobile/badges/gpa.svg)](https://codeclimate.com/github/jpmobile/jpmobile)
+
+# jpmobile: A Rails plugin for Japanese mobile-phones
+
+## jpmobileとは
+携帯電話特有の機能を Rails 5.0 や Rack middleware で利用するためのプラグイン。 以下の機能を備える。
+
+* 携帯電話のキャリア判別
+* 端末位置情報の取得
+    * [GeoKit](http://geokit.rubyforge.org) との連携
+
+* 端末製造番号、契約者番号等の取得
+* IPアドレスの検証(キャリアが公開しているIPアドレス帯域からのアクセスか判定)
+    * IPアドレスの検証には
+        [jpmobile-ipaddresses](http://github.com/jpmobile/jpmobile-ipaddresses
+        ) が必要です。
+
+* ディスプレイ情報(画面サイズ、ブラウザ画面サイズ、カラー・白黒、色数)の取得
+    * ディスプレイ情報の取得には
+        [jpmobile-terminfo](http://github.com/jpmobile/jpmobile-terminfo)
+        が必要です。
+
+* 文字コード変換機能／絵文字のキャリア間相互変換
+* メールの送信
+    * 絵文字と漢字コードの変換
+
+* メールの受信(experimental)
+    * 絵文字と漢字コードの変換
+
+また Rails 5.0 に以下の機能を追加する
+* ビューへの自動振分け
+* 位置情報取得などのリンクヘルパーの追加
+* セッションIDをフォーム／リンクに付与(Trans SID)
+
+他のバージョンの Rails については [Versions : Jpmobile vs
+Rails](https://github.com/jpmobile/jpmobile/wiki/Version-:-Jpmobile-vs-Rails)
+を参照。
+
+## インストール
+### Rails pluginとしてインストールする場合
+```shell
+% rails plugin install git://github.com/jpmobile/jpmobile.git
+```
+
+#### IPアドレス検証が必要な場合
+```shell
+% rails plugin install git://github.com/jpmobile/jpmobile-ipaddresses.git
+```
+
+#### ディスプレイ情報を取得する必要がある場合
+```shell
+% rails plugin install git://github.com/jpmobile/jpmobile-terminfo.git
+```
+
+### gemでインストールする場合
+```shell
+% gem install jpmobile
+```
+
+#### IPアドレス検証が必要な場合
+```shell
+% gem install jpmobile-ipaddresses
+```
+
+#### ディスプレイ情報を取得する必要がある場合
+```shell
+% gem install jpmobile-terminfo
+```
+
+## 使用例
+
+### 携帯電話の識別
+環境変数 `ENV['rack.jpmobile']` にキャリアクラスのインスタンスが格納されています。また Rack::Request#mobile
+としても取得可能です。
+
+#### キャリアの識別
+
+```ruby
+case request.mobile
+when Jpmobile::Mobile::Docomo
+  # for DoCoMo
+when Jpmobile::Mobile::Au
+  # for au
+when Jpmobile::Mobile::Softbank
+  # for SoftBank
+when Jpmobile::Mobile::Willcom
+  # for Willcom
+when Jpmobile::Mobile::Emobile
+  # for EMOBILE
+else
+  # for PC
+end
+```
+
+あるいは
+```ruby
+if request.mobile.is_a?(Jpmobile::Mobile::Docomo)
+  # for DoCoMo
+end
+```
+
+#### ビューの中で一部を切替える例
+```ruby
+<% if request.mobile? %>
+  携帯電話からのアクセスです。
+<% else %>
+  携帯電話からのアクセスではありません。
+<% end %>
+
+<% if request.smart_phone? %>
+  スマートフォンからのアクセスです。
+<% else %>
+  スマートフォンからのアクセスではありません。
+<% end %>
+
+<% if request.tablet? %>
+  タブレットからのアクセスです。
+<% else %>
+  タブレットからのアクセスではありません。
+<% end %>
+```
+
+#### 別に用意した携帯電話用コントローラへリダイレクトする例
+```ruby
+class PcController < ApplicationController
+  before_action :redirect_if_mobile
+
+  def index
+  end
+
+  private
+  def redirect_if_mobile
+    if request.mobile?
+      pa = params.dup
+      pa[:controller] = "/mobile"
+      redirect_to pa
+    elsif request.smart_phone?
+      pa = params.dup
+      pa[:controller] = "/smart_phone"
+      redirect_to pa
+    end
+  end
+end
+
+class MobileController < ApplicationController
+end
+```
+
+### 位置情報の取得
+Rack::Request#mobile.position に位置情報が格納されます。
+
+```ruby
+@latitude   = request.mobile.position.lat
+@longuitude = request.mobile.position.lon
+```
+
+#### [GeoKit](http://geokit.rubyforge.org) との連携
+
+vendor/plugins/geokit以下にGeoKitがインストールされていると、Jpmobile::PositionにGeoKit::Mappabl
+eがincludeされる。したがって、
+
+```ruby
+request.mobile.position.distance_to('札幌駅')
+```
+
+とすることで、端末と「札幌駅」との距離を求めることができる。詳細は http://geokit.rubyforge.org/api/index.html
+参照。
+
+### 端末情報の取得
+
+端末側から通知されている場合、request.mobile.ident で 契約に固有の識別子もしくは端末の製造番号を取得できる。
+両方存在する場合は契約に固有のIDが優先される。
+
+* 契約に固有のID (request.mobile.ident_subscriber)
+    * au: EZ番号(サブスクライバ番号)
+    * DoCoMo: FOMAカード製造番号
+    * EMOBILE: EMnet対応端末から通知されるユニークなユーザID
+
+* 端末製造番号 (request.mobile.ident_device)
+    * DoCoMo: 端末製造番号(FOMA, MOVA)
+    * SoftBank: 製造番号
+
+### IPの検証
+キャリアが公開しているIPアドレス帯域からのアクセスか判定する。
+```ruby
+request.mobile.valid_ip?
+```
+
+ただし [jpmobile-ipaddresses](http://github.com/jpmobile/jpmobile-ipaddresses)
+がインストールされていないか、スマートフォンの場合は必ずfalseとなる。
+
+### 端末の画面サイズ
+request.mobile.display で Jpmobile::Display クラスのインスタンスが返る。
+
+```ruby
+画面幅 <%= request.mobile.display.width %>
+画面高さ <%= request.mobile.display.height %>
+```
+
+ただし [jpmobile-terminfo](http://github.com/jpmobile/jpmobile-terminfo)
+がインストールされていない場合はエラーとなるので注意が必要。
+
+### 文字コード変換機能／絵文字のキャリア間相互変換
+
+jpmobileを読み込むとDoCoMo、Au、SoftBankの絵文字を透過的に扱うことができる。
+
+* Rails の場合は vendor/plugins に配置し、下記の設定を追加することで有効になる。
+    ```ruby
+    # Rack middleware を追加するメソッド
+    Rails.application.config.jpmobile.mobile_filter
+      or
+    Jpmobile.config.mobile_filter
+    ```
+
+    * 下記の設定を追加することで、<form> タグの accept-charset が変更される。
+
+        ```ruby
+        # <form accept-charset="Shift_JIS" ...> などに変更する
+        Rails.application.config.jpmobile.form_accept_charset_conversion = true
+          or
+        Jpmobile.config.form_accept_charset_conversion = true
+        ```
+
+    * Andriod/iPhone では Google 絵文字や Unicode 6.0
+        絵文字が使われています。下記の設定を追加すると、互換性をもたせるために3キャリアの絵文字に変換することができます。また表示の変換も可能です。
+
+        ```ruby
+        Rails.application.config.jpmobile.smart_phone_emoticon_compatibility = true
+          or
+        Jpmobile.config.smart_phone_emoticon_compatibility = true
+        ```
+
+携帯電話上では特に問題とならない。PCブラウザでテストする際に問題となるためのオプション。
+
+* Sinatra の場合は下記のように指定する。
+    ```ruby
+    $LOAD_PATH << './lib/jpmobile/lib'
+    require 'jpmobile'
+    require 'jpmobile/rack'
+
+    use Jpmobile::Rack::MobileCarrier
+    use Jpmobile::Rack::ParamsFilter
+    use Jpmobile::Rack::Filter
+
+    get '/' do
+      erb :index
+    end
+    ```
+
+Rails のみ半角・全角の自動変換フィルターが用意されている。用いるには
+    ```ruby
+    class MyController
+      hankaku_filter
+    end
+    ```
+
+と指定する。またtextareaやhidden/text/passwordのinputタグで半角に変換したくない場合は :input => true
+を指定する。このときNokogiriが必要となるため、Gemfileに追記してインストールする必要がある。
+    ```ruby
+    class MyController
+      hankaku_filter :input => true
+    end
+    ```
+
+Jpmobile内では、各キャリアの絵文字はUnicode私的領域上にマッピングされ、管理される。
+このとき、DoCoMo、Auは公式サイト記載のマッピングが使用される。
+ただしSoftBankはAuとの重複を避けるため、公式のマッピングに0x1000加算しU+F001以降に割り当てる。
+テンプレート内ではUTF-8でエンコードするか、数値文字参照の&#xHHHH;形式で指定する。
+
+絵文字は送出時に内蔵の変換表に基づいて変換され、携帯電話のエンコーディングにあわせて送出される。
+携帯電話から受信した絵文字は上記マッピングに基づいてUTF-8でparamsに渡される。
+
+* DoCoMo、Auとの通信時にはShift_JIS、SoftBankとの通信時にはUTF-8が使用される。
+* :hankaku=>true指定時は、カタカナは半角カナに変換されて送出される。携帯電話から送られた半角カナは全角カナに変換される。
+* 絵文字はキャリアにあわせて変換されて送出される。
+* 携帯電話からの絵文字はUnicode私的領域にマップされ、UTF-8でparamsに格納される。
+
+### ビューの自動振り分け
+ビューの自動振り分けを行うには、以下の設定が必要です。
+
+```ruby
+class ApplicationController < ActionController::Base
+  include Jpmobile::ViewSelector
+end
+```
+
+DoCoMo携帯電話からアクセスすると、
+* index_mobile_docomo.html.erb
+* index_mobile.html.erb
+* index.html.erb
+
+の順でテンプレートを検索し、最初に見付かったテンプレートが利用される。
+Auの場合は、index_mobile_au.html.erb、Softbankの場合はindex_mobile_softbank.html.erbが最初に
+検索される。
+
+またiPhoneからアクセスすると、
+* index_smart_phone_iphone.html.erb
+* index_smart_phone.html.erb
+* index.html.erb
+
+の順でテンプレートを検索する。 Androidの場合はindex_smart_phone_android.html.erb、Windows
+Phoneの場合はindex_smart_phone_windows_phone.html.erbが最初に検索される。
+
+自動振り分けを無効化するには、アクションにおいて以下のように設定する
+
+```ruby
+def index
+  disable_mobile_view!
+end
+```
+
+### 位置情報の取得用リンクの生成
+
+以下のようなコードで、端末に位置情報を要求するリンクを出力する。
+
+```ruby
+<%= get_position_link_to("位置情報を取得する", :action=>:gps) %>
+```ruby
+
+### セッションIDの付与(Trans SID)
+#### Cookie非対応携帯だけに付与する
+
+```ruby
+class MyController
+  trans_sid
+end
+```
+
+#### PCにも付与する
+
+```ruby
+class MyController
+  trans_sid :always
+end
+```
+
+trans_sid 機能を使う場合には、cookie session store を使用することができず、
+active_record_storeのgemパッケージが必要です。 また Rails 5.0 では Cookie
+が使える場合にはそちらが優先されてしまうため、:always を指定した場合に問題になる場合があります。 trans_sid を使用する際には、例えば
+config/initializers/session_store.rb で
+
+```ruby
+Rails.application.config.session_store :active_record_store
+Rails.application.config.session_options = {:cookie_only => false}
+```
+
+として active_record_store を使用するように設定し、:cookie_only => false として Cookie
+を優先しないように設定します。 このとき ApplicationController において protect_from_forgery の :secret
+を指定するか、 あるいは protect_from_forgery を解除する必要があるでしょう。
+
+また、
+
+```ruby
+link_to "hoge", "/controller/action/id"
+```ruby
+
+のようにリンク先を直接指定するとセッションIDは付加されません。
+
+```ruby
+link_to "hoge", :controller => "controller", :action => "action", :id => "id"
+```
+
+のように指定する必要があります。
+
+### メールの送受信
+メールにて絵文字や漢字コードの変換、ビューの自動振り分けを行なうには Jpmobile::Mailer::Base を使う。
+
+```ruby
+class MobileMailer < Jpmobile::Mailer::Base
+  default :from => "info@jpmobile-rails.org"
+
+  def registration(to)
+    mail(:to => to)
+  end
+
+  def receive(email)
+    email
+  end
+end
+```
+
+* デフォルトで ISO-2022-JP エンコードで送信
+* docomo/SoftBank には Shift_JIS で送信
+* au は ISO-2022-JP エンコードで送信
+* ビューやレイアウトの自動振り分け
+    * docomo であれば
+        app/views/mobile_mailer/registration_mobile_docomo.html.erb など
+
+* 受信に関しては、docomo/SoftBank でテストできていないため、実験版とします。
+    * テストして問題あれば随時報告してください。
+
+* オプションに :decorated => true を追加すると、各キャリアのデコメに適したフォーマットで送信します。
+    * ただし docomo/SoftBank でテスト出来ていないため、実験版とします。
+
+## jpmobileの開発方法
+
+jpmobileの開発に関しては
+[こちら](https://github.com/jpmobile/jpmobile/blob/master/CONTRIBUTING.md) へ
+
+## リンク
+
+* http://jpmobile-rails.org
+
+## 作者
+
+Copyright 2006-2012 (c) Yoji Shidara, under MIT License.
+
+Shin-ichiro OGAWA <rust.stnard@gmail.com>, Yoji Shidara <dara@shidara.net>