Windows環境でRedmine Pluginの開発環境を構築する

これは何？

• Windows環境でRedmineのプラグインを開発する環境を整えた際のメモ
• WindowsはXP、Windows Server 2012 R2 で試した。

手順

開発環境のサーバを立ち上げるまで

1. bitnamiのページからRedmineの最新版をダウンロード
2. Redmineのインストール先を C:\Bitnami\redmine-2.5.2-2にする。（フォルダはredmineバージョンに従う）ここで初期ユーザの登録時のパスワードは後のMySQLのrootのパスワードにもなる。
3. 環境変数パスに C:\Bitnami\redmine-2.5.2-2\ruby\bin を追加する。
4. ruby -v でrubyのバージョンがruby 2.0.0p481 (2014-05-08) [i386-mingw32]が出ることを確認。
5. C:\Bitnami\redmine-2.5.2-2\apps\redmine\htdocsにcdする
6. gem install bundler を実行する
7. bundle install
8. set RAILS_ENV=production
9. bundle exec rake generate_secret_token
10. テスト用のDBのパスワードをインストール時に作った初期ユーザのパスワードに変えておく。C:\Bitnami\redmine-2.5.2-2\apps\redmine\htdocs\config\database.yamlの中身を変更する。

database.yaml

development:
  adapter: mysql2
  database: redmine_development
  host: localhost
  username: root
  password: # here #
  encoding: utf8

1. bundle exec rake db:create
2. テスト用のDBのパスワードを空白に戻す。C:\Bitnami\redmine-2.5.2-2\apps\redmine\htdocs\config\database.yamlの中身を変更する。

database.yaml

development:
  adapter: mysql2
  database: redmine_development
  host: localhost
  username: root
  password: "" # here #
  encoding: utf8

1. bundle exec rake db:migrate
2. bundle exec rake redmine:load_default_data
3. C:\Bitnami\redmine-2.5.2-2\apps\redmine\htdocs\config\additional_enviromant.rbのconfig.action_controller.relative_url_rootの行をコメントアウトする
4. bundle exec rails server webrick or bundle exec rails server でサーバを起動

plugin開発をするまで

1. C:\Bitnami\redmine-2.5.2-2\apps\redmine\htdocs をカレントディレクトリにしておく。
2. 下記のコマンドを打つ

ruby script/rails generate redmine_plugin redmine_standard

※ redmine_standard　という名前は任意。

ここら辺までできれば、参考資料を参考に進めるとよい。

既にあるプラグインを導入する場合

～テーブルがありません的なエラーにお目にかかると思われます。
下記のコマンドを打ってみましょう。（プラグインで使うDBテーブルを作るコマンド）

bundle exec rake redmine:plugins:migrate

参考資料

• Rails を知らない人のための Redmine プラグイン開発ガイド
  • Railsを知らない前提で解説していただけるので助かる。
• プラグイン チュートリアル（公式日本語訳？）
• rake xxx と bundle exec rake xxx の違い
  • bundle exec ってなんでいちいちつけんのよって話が気になったらコチラ。