Rake 是 Ruby 领域的 Make,是个独立的 Ruby 工具,目的是代替 Unix 中的 make。Rake 根据 Rakefile 和 .rake 文件构建任务。Rails 使用 Rake 实现常见的管理任务,尤其是较为复杂的任务。
rake about # List versions of all Rai...
rake assets:clean[keep] # Remove old compiled assets
rake assets:clobber # Remove compiled assets
rake assets:environment # Load asset compile envir...
rake assets:precompile # Compile all the assets n...
rake churn # Report the current churn...
rake clean # Remove any temporary pro...
rake clobber # Remove any generated file
rake code_metrics:line_statistics[file_pattern] # Report LOC for each file...
rake code_metrics:stats # Report code statistics (...
rake customer_management:install:migrations # Copy migrations ...
rake customer_service:install:migrations # Copy migrations from cus...
rake db:create # Create the database from...
rake db:drop # Drops the database using...
rake db:fixtures:load # Load fixtures into the c...
rake db:migrate # Migrate the database (op...
rake db:migrate:status # Display status of migrat...
rake about
rake about 任务输出以下信息:Ruby、RubyGems、Rails 的版本号,Rails 使用的组件,程序所在的文件夹,Rails 当前所处的环境名,程序使用的数据库适配器,数据库模式版本号。如果想向他人需求帮助,检查安全补丁是否影响程序,或者需要查看现有 Rails 程序的信息,可以使用这个任务。
rake assets:precompile 任务会预编译 app/assets 文件夹中的静态资源文件。rake assets:clean 任务会把编译好的静态资源文件删除。
Rake 命名空间 db: 中最常用的任务是 migrate 和 create,这两个任务会尝试运行所有迁移相关的 Rake 任务(up,down,redo,reset)。rake db:version 在排查问题时很有用,会输出数据库的当前版本。
Current version: 20140820034433
db:charset 检索当前环境下数据库的字符设置
db:collation 检索当前环境下数据库的校对
db:create 用config\database.yml中的定义创建当前 RAILS_ENV 项目环境下的数据库
db:create:all 用config\database.yml中的定义创建所有数据库
db:drop 删除当前 RAILS_ENV项目环境中的数据库
db:drop:all 删除所有在 config\database.yml中定义的数据库
db:reset 从db\schema.rb中为当前环境重建数据库(先删后建).
db:rollback 回滚(清华出版社一本SQLSERVER书的名词[很奇怪为什么不直接用滚回])数据库到前一个版本. 指定回滚到哪一步要用 STEP=n 参数
db:version 检索当前模式下的版本
备份数据库
rake db:backup:create 根据database.yml的信息备份数据库
rake db:backup:destroy 默认删除一天前的备份数据
rake db:backup:rebuild 默认恢复最新的备份数据
doc: 命名空间中的任务可以生成程序的文档,Rails API 文档和 Rails 指南。生成的文档可以随意分割,减少程序的大小,适合在嵌入式平台使用。
rake doc:app 在 doc/app 文件夹中生成程序的文档;
rake doc:guides 在 doc/guides 文件夹中生成 Rails 指南;
rake doc:rails 在 doc/api 文件夹中生成 Rails API 文档;
rake routes 会列出程序中定义的所有路由,可为解决路由问题提供帮助,还可以让你对程序中的所有 URL 有个整体了解。
rake time:zones:all 列出 Rails 能理解的所有时区
rake stats输出你应用程序的有用统计,显示千行代码数和测试比例等
以坐火车为例:
分:1.买票2.进站3.乘车
在rakefile文件中写这么一个task
task :action1 do
puts "买票"
end
task :action2 do
puts "进站"
end
task :action3 do
puts "乘车"
end
rake action1
买票
rake action2
进站
rake action3
乘车
自己编写的rake任务保存在rails root/lib/tasks中,扩展名:.rake
如果在任务中要和程序的模型交互,例如查询数据库等,可用environment任务,加载程序代码。
multitask: copy_files => [copy_src, :copy_doc, :copy_bin] do
puts "..............."
end
copy_files是一个普通那个任务,它的动作在所有依赖任务完成后才会执行,但copy_src, copy_doc, copy_bin这三个任务会并行执行,他们之间并无影响,如果这三个任务还依赖于其他共同的任务copy_all,则当copy_all执行完后才执行这三个任务
如果有release任务需要版本号作参数:rake release[0.8.2]
这样参数release就会传递给release任务,多个参数可以以逗号隔开,列表形式传递给任务:rake name[jon,doe]
rake任务及其参数是以单个命令行参数传递给rake的,即中间不允许有空格。如果任务名和参数名包含空格则需使用引号:
rake ''name [billy bob,jon]"
rake release[0.8.2]可以写成rake release RELEASE_VERSION = 0.8.2
必须声明接收参数的任务才能接收参数
task:name,[:first_name,:last_name]
[:first_name,:last_name]为name任务需要接收的参数
利用task块的第二个参数可以在动作中访问传递过来的参数
task:name,[:first_name, :last_name] do |t,args|
puts "first name is #{args.first_name}"
end
块中的t总是绑定为当前任务对象,第二个参数args就是传递过来的参数对象
为参数指定默认值
task :name,[:first_name, :last_name] do |t,args|
args.with_defaults(:first_name => ''jon", :last_name => "jan"
end
命名空间
当rake文件很多时,当你有很多任务的时候,你需要关注它们的命名冲突问题,命名空间(namespace)就是一个自然的解决方案。你可以为上面的三个任务定义一个叫做home的命名空间。
namespace :home do
task :action1 do rake home:action1
puts "买票"
end rake home:action2
task :action2 => :action1 do
puts "进站" rake home:action3
end
task :action3 => :action3 do
puts "乘车"
end
end
desc 可以使用ruby标准注释#,但如果希使用rake - T来显示任务的描述,就需要使用desc命令描述任务