{"id":4496,"date":"2010-05-28T16:32:30","date_gmt":"2010-05-28T08:32:30","guid":{"rendered":"http:\/\/ihower.tw\/blog\/?p=4496"},"modified":"2011-04-09T01:50:20","modified_gmt":"2011-04-08T17:50:20","slug":"rubygems-development","status":"publish","type":"post","link":"https:\/\/ihower.tw\/blog\/4496-rubygems-development","title":{"rendered":"Rubygems \u5957\u4ef6\u7ba1\u7406\u5de5\u5177"},"content":{"rendered":"

(\u672c\u7bc7\u7684\u5c0d\u8c61\u662f Library \u958b\u767c\u8005\uff0c\u5982\u679c\u60a8\u662f\u55ae\u7d14\u7684 Library \u4f7f\u7528\u8005\uff0c\u53ef\u4ee5\u5148\u53c3\u8003 RubyGems \u7c21\u4ecb<\/a>)<\/p>\n

\u5957\u53e5\u6d41\u884c\u7684\u8a71\uff0cRubyForge Must Die!! \u5927\u6982\u662f\u4eca\u5e74\u4e8c\u6708\u5e95\u7684\u4e8b\u60c5 (\u5916\u96fb\u5831\u5c0e<\/a>\u3001\u7c21\u4e2d\u7ffb\u8b6f<\/a>)\uff0c\u65b0\u7684 gemcutter.org<\/a> \u53d6\u4ee3\u4e86 rubyforge.org<\/a>\uff0c\u76ee\u524d\u5df2\u7d93\u6210\u70ba Ruby \u793e\u7fa4\u7684\u5b98\u65b9 Gem \u5132\u5b58\u5eab\uff1arubygems.org<\/a>\uff0c\u5305\u62ec gems.rubyforge.org<\/a> \u4e5f\u662f\u6307\u5411 rubygems.org<\/a>\u3002<\/p>\n

RubyForge.org<\/a> \u6700\u5927\u7684\u554f\u984c\u4e4b\u4e00\uff0c\u5c31\u662f\u4ed6\u4e0d\u662f\u7528 Ruby \u5beb\u7684(\u7121\u8aa4)\uff0c\u800c\u65b0\u7684 rubygems.org<\/a>\uff0c\u4f7f\u7528\u4e86 Rails \u7576\u505a\u524d\u53f0\uff0c\u4ee5\u53ca Sinatra \u7576\u505a Gem server\uff0c\u80cc\u5f8c\u6280\u8853\u5305\u62ec delayed::job \u8ddf Amazon S3 \u4f86\u8655\u7406\u6240\u6709\u4e0a\u50b3\u7684 Gem package\uff0c\u8b93\u767c\u4f48 Gem \u7684\u901f\u5ea6\u4e5f\u5927\u5927\u63d0\u6607\u3002\u6574\u500b\u7ad9\u751a\u81f3\u4e5f open source \u51fa\u4f86\u5728 github.com\/qrush\/gemcutter<\/a>\u3002\u554f\u984c\u4e4b\u4e8c\uff0c\u5c31\u662f RubyForge \u7684\u4ecb\u9762\u5be6\u5728\u4e0d\u600e\u9ebc\u6a23\uff0c\u529f\u80fd\u4e5f\u96dc\u4e82\uff0c\u800c\u65b0 rubygems.org<\/a> \u6709\u8457\u5168\u65b0\u7684\u7c21\u6f54\u4ecb\u9762\uff0c\u63d0\u4f9b\u5177\u6709\u89aa\u548c\u529b\u7684\u8cc7\u8a0a\u3002\u554f\u984c\u4e4b\u4e09\uff0c\u5c31\u662f API \u4e86\uff0c\u65b0\u7684 rubygems.org<\/a> \u914d\u5408\u65b0\u7248\u7684 rubygems library (1.3.6\u4ee5\u4e0a\uff0c\u5982\u679c\u4f60\u9084\u6c92\u5347\u7d1a\uff0c\u8acb\u6253 sudo gem update –system)\uff0c\u8b93\u767c\u4f48 Gem \u8b8a\u5f97\u975e\u5e38\u7c21\u55ae\u3002<\/p>\n

\u9084\u6709\u500b\u63d2\u66f2\uff0c\u4e4b\u524d github.com<\/a> \u6709\u4e00\u5ea6\u53ef\u4ee5\u652f\u63f4\u7576\u505a Gem server\uff0c\u4e0d\u904e\u81ea\u5f9e gemcutter \u8a08\u756b\u5c55\u958b\u4e4b\u5f8c\uff0c\u4ed6\u5011\u5c31\u6c7a\u5b9a\u53d6\u6d88\u9019\u500b\u529f\u80fd\uff0c\u8acb\u898b hasmygembuiltyet.org<\/a>\u3002<\/p>\n

\u5982\u4f55\u6253\u5305\u53ca\u767c\u4f48 Gem<\/h3>\n

\u8aaa\u5230\u767c\u4f48 Gem \u554a\uff0c\u6211\u4e00\u76f4\u4ee5\u70ba\u662f\u6709\u9ede\u9ebb\u7169\u7684\u4e8b\u60c5\uff0c\u6700\u65e9\u6211\u66fe\u7d93\u7528\u904e Hoe<\/a>\uff0c\u4e5f\u770b\u904e jeweler<\/a> \u9019\u500b\u5de5\u5177\u3002\u4e0d\u904e\u4e00\u76f4\u5230\u524d\u4e00\u9663\u5b50\u770b\u4e86 Yehuda \u7684 Using .gemspecs as Intended<\/a> \u9019\u7bc7\u6587\u7ae0\u4e4b\u5f8c\uff0c\u624d\u767c\u73fe\u5176\u5be6\u5f88\u7c21\u55ae\uff0c\u6839\u672c\u4e0d\u9700\u8981\u7528\u5230\u5176\u9918\u7684\u5de5\u5177\u554a\uff0c\u90a3\u5230\u5e95\u8981\u600e\u9ebc\u505a\u5462?<\/p>\n

\u9996\u5148\uff0c\u6211\u5011\u8981\u628a\u4f60\u7684 library \u6253\u5305\u6210\u4e00\u500b Gem package\uff0c\u5047\u8a2d\u6211\u5011\u7684 library \u53eb foobar \u597d\u4e86\uff1a<\/p>\n

\u6b65\u9a5f\u4e00\uff1a \u64b0\u5beb foobar.gemspec \u6a94\uff0c\u9019\u662f\u4e00\u500b\u63cf\u8ff0 Gem package \u7684 metadata \u6a94\u6848\u3002\u4ee5\u4e0b\u662f\u4e00\u500b\u57fa\u672c\u5920\u7528\u7684\u7bc4\u4f8b\u3002\u5982\u540c Yehuda \u6240\u8aaa\u7684\uff0c\u4f60\u5176\u5be6\u4e0d\u9700\u8981\u7528\u5176\u4ed6\u7684\u5de5\u5177\u4f86\u7522\u751f\u9019\u500b gemspec \u6a94\u6848\u3002<\/p>\n

 \r\n\r\n Gem::Specification.new do |s|\r\n  s.name        = \"foobar\"\r\n  s.version     = \"1.1.1\"\r\n  s.date        = \"2010-05-14\"\r\n  s.authors     = [\"Wen-Tien Chang\"]\r\n  s.email       = [\"ihower@gmail.com\"]\r\n  s.homepage    = \"http:\/\/example.org\"\r\n  s.summary     = \"blah\"\r\n  s.description = \"blah blah\"\r\n \r\n  # s.add_dependency('log4r', '>= 1.0.5')\r\n  # s.add_dependency('log4r', '~> 1.1.0') # \u8868\u793a 1.1.y \u90fd\u53ef\u4ee5 \r\n  # s.add_dependency('log4r', '~> 1.0') # \u8868\u793a 1.x.y \u90fd\u53ef\u4ee5 \r\n  # s.add_runtime_dependency # add_dependency \u7684\u5225\u540d\r\n  # s.add_development_dependency # \u53ea\u6709\u5728 gem install xxx --development \u624d\u6703\u5b89\u88dd\r\n   \r\n  s.files = Dir.glob(\"{lib}\/**\/*\") + %w(LICENSE README) # \u53ea\u6709\u5217\u5728\u9019\u88e1\u7684\u6a94\u6848\u6703\u6253\u5305\u5230 Gem package \u88e1\u9762\u3002\r\n  # s.executables = [] # \u653e\u5728 bin \u4e0b\u7684\u57f7\u884c\u6a94\u6709\u54ea\u4e9b\r\nend\r\n<\/code>\r\n<\/pre>\n
Update1: \u9019\u88e1\u6709\u53e6\u4e00\u500b\u7bc4\u4f8b\u53c3\u8003 Be awesome: write your .gemspec yourself<\/a>
\nUpdate2: Bundler \u4e5f\u53ef\u4ee5\u7522\u751f\u7a7a\u7684 Gem\uff0c\u5982\u679c\u60f3\u8b93 library \u4e5f\u7528 bundler \u7ba1\u7406 gem dependencies \u53ef\u4ee5\u8003\u616eDeveloping a RubyGem using Bundler<\/a> <\/p>\n
\u66f4\u591a\u5b8c\u6574\u7684\u898f\u683c\u8acb\u53c3\u8003 docs.rubygems.org\/read\/chapter\/20<\/a><\/p>\n
\u6b65\u9a5f\u4e8c\uff1a\u57f7\u884c gem build foobar.gemspec \u4fbf\u6703\u5305\u88dd\u51fa\u55ae\u4e00 Gem package \u5957\u4ef6\u6a94 foobar-1.1.1.gem<\/p>\n
\u9019\u6642\u5019\uff0c\u4f60\u5c31\u53ef\u4ee5\u900f\u904e gem install foobar-1.1.1.gem \u4f86\u5b89\u88dd\u5230\u81ea\u5df1\u7684\u96fb\u8166\u4e86\u3002\u5982\u679c\u8dd1 gem server \u8d77\u4f86\uff0c\u5225\u4eba\u4e5f\u53ef\u4ee5\u900f\u904e\u4f60\u7684 gem server \u5b89\u88dd\u9019\u500b\u5957\u4ef6 (gem install GEMNAME –source http:\/\/your_gem_server_host:8808)\u3002<\/p>\n
\u63a5\u4e0b\u4f86\uff0c\u600e\u9ebc\u767c\u4f48 Gem \u5230 rubygems.org<\/a> \u8b93\u5168\u4e16\u754c\u7684\u958b\u767c\u8005\u90fd\u53ef\u4ee5\u5b89\u88dd\u4f60\u7684\u5927\u4f5c\u5462? \u5728 Rubygems 1.3.6 \u4e4b\u5f8c\u5df2\u7d93\u5167\u5efa\u6709 gem push \u529f\u80fd\uff1a<\/p>\n
\u6b65\u9a5f\u4e00\uff1a\u5728 rubygems.org\/<\/a> \u8a3b\u518a\u4e00\u500b\u5e33\u865f\uff0c\u62ff\u5230 API key\uff0c\u52a0\u5230 ~\/.gem\/credentials \u88e1\u3002
\n\u6b65\u9a5f\u4e8c\uff1a\u57f7\u884c gem push foobar-1.1.1.gem \u5c31\u6703\u767c\u4f48\u51fa\u53bb\u4e86<\/p>\n
Ruby Library \u6700\u4f73\u5be6\u52d9<\/h3>\n
Update: \u53ef\u4ee5\u53c3\u8003 Ruby Packaging Standard, 0.5-draft<\/a><\/p>\n
\u4e00\u500b Ruby library \u7684\u7d44\u6210\uff0c\u5927\u81f4\u90fd\u662f\u9019\u6a23\u7684\uff1a<\/p>\n
* README
\n* lib \u76ee\u9304\u548c\u6703\u88ab\u4f7f\u7528\u8005 require \u7684\u6a94\u6848\uff0c\u4f8b\u5982 lib\/foobar.rb
\n* test \u76ee\u9304 (optional)
\n* example (optional)
\n* bin \u76ee\u9304 (\u6709\u57f7\u884c\u6a94\u7684\u8a71)
\n* LICENSE<\/p>\n
\u5982\u679c\u4f60\u6c92\u4ec0\u9ebc\u6982\u5ff5\uff0c\u53ef\u4ee5\u770b\u770b Ruby Best Practice<\/a> \u4e00\u66f8\u7684\u7b2c\u516b\u7ae0 Skillful Project Maintenance\uff0c\u4f5c\u8005\u8b1b\u89e3\u4e86\u4e00\u500b Ruby Library Project \u7684\u7d44\u6210\uff0c\u9084\u6709\u4ecb\u7d39\u5230\u5982\u4f55\u7528 RDoc \u8ddf Rakefile\u3002\u5982\u679c\u4f60\u6bd4\u8f03\u521d\u5b78\uff0c\u5efa\u8b70\u4e00\u770b\u3002<\/p>\n
\u63a5\u8457 Gem Packaging: Best Practices<\/a> \u9019\u4e00\u7bc7\u975e\u5e38\u503c\u5f97\u4e00\u770b\uff0c\u4ecb\u7d39\u4e00\u4e9b\u6700\u4f73\u5be6\u52d9\uff0c\u50cf\u662f\uff1a<\/p>\n
1. \u4e0d\u8981\u5728\u4f60\u7684 library \u88e1\u4f9d\u8cf4 rubygems\u3002\u4f8b\u5982 require ‘rubygems’\u3001rescue Gem::Load\u3001gem “foo” \u7b49\u7b49\u90fd\u4e0d\u8981\u7528
\n2. \u56e0\u70ba lib \u9019\u4e00\u5c64\u76ee\u9304\u6703\u9032 $LOAD_PATH\uff0c\u6240\u4ee5\u4e0d\u8981\u653e\u4e0d\u662f\u8981\u7d66\u7d42\u7aef\u4f7f\u7528\u8005 require \u7684\u6a94\u6848\u5728 lib \u4e0b (\u800c\u4e14\u547d\u540d\u4e5f\u4e0d\u8981\u592a general\uff0c\u4e0d\u7136\u53ef\u80fd\u6703\u8ddf\u5176\u4ed6 library \u649e\u5230\u540d\u5b57)\uff0c\u5176\u4ed6\u6a94\u6848\u7528 module namespace \u7684\u65b9\u5f0f\u653e\u5230 lib \u7684\u5b50\u76ee\u9304\u4e0b\u3002\u4f8b\u5982\u4f60\u770b github.com\/nex3\/haml<\/a> \u7684 lib \u4e0b\u5c31\u53ea\u653e\u4e86 haml.rb \u8ddf sass.rb\u3002
\n3. \u627f\u4e0a\uff0c\u5728 foobar.rb \u4e2d\u5982\u679c\u8981 require \u5176\u4ed6\u6a94\u6848\uff0c\u4e0d\u9700\u8981\u5beb File.dirname(__FILE__) \uff0c\u76f4\u63a5 require “foo\/bar” \u5c31\u6703 require lib\/foo\/bar.rb \u9019\u500b\u6a94\u6848\u4e86\u3002<\/p>\n
\u5982\u679c\u4f60\u60f3\u7e7c\u7e8c\u591a\u4e86\u89e3\u4e00\u4e9b\u6545\u4e8b\uff0c\u53ef\u4ee5\u770b\u770b\uff1a<\/p>\n
* Gemcutter(rubygems.org<\/a>) \u4f5c\u8005\u5728 RubyConf 2009 \u7684\u6f14\u8b1b\uff1aGemcutter: The Next Step in Gem Hosting<\/a> \u4ee5\u53ca\u4ed6\u7684\u6295\u5f71\u7247 next.heroku.com\/<\/a>
\n* Yuhada \u5728 RubyConf 2009 \u7684\u6f14\u8b1b\uff1a Polishing Rubygems<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"
(\u672c\u7bc7\u7684\u5c0d\u8c61\u662f Library \u958b\u767c\u8005\uff0c\u5982\u679c\u60a8\u662f\u55ae\u7d14\u7684 Library \u4f7f\u7528\u8005\uff0c\u53ef\u4ee5\u5148\u53c3\u8003 RubyGems  … <\/p>\n
\u95b1\u8b80\u5168\u6587\u3008Rubygems \u5957\u4ef6\u7ba1\u7406\u5de5\u5177\u3009<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"jetpack_post_was_ever_published":false,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":false,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2}},"categories":[31],"tags":[],"class_list":["post-4496","post","type-post","status-publish","format-standard","hentry","category-ruby","entry"],"jetpack_publicize_connections":[],"jetpack_featured_media_url":"","jetpack_shortlink":"https:\/\/wp.me\/p1q6tG-1aw","jetpack_sharing_enabled":true,"jetpack_likes_enabled":true,"_links":{"self":[{"href":"https:\/\/ihower.tw\/blog\/wp-json\/wp\/v2\/posts\/4496","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ihower.tw\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/ihower.tw\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/ihower.tw\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/ihower.tw\/blog\/wp-json\/wp\/v2\/comments?post=4496"}],"version-history":[{"count":30,"href":"https:\/\/ihower.tw\/blog\/wp-json\/wp\/v2\/posts\/4496\/revisions"}],"predecessor-version":[{"id":5519,"href":"https:\/\/ihower.tw\/blog\/wp-json\/wp\/v2\/posts\/4496\/revisions\/5519"}],"wp:attachment":[{"href":"https:\/\/ihower.tw\/blog\/wp-json\/wp\/v2\/media?parent=4496"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ihower.tw\/blog\/wp-json\/wp\/v2\/categories?post=4496"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ihower.tw\/blog\/wp-json\/wp\/v2\/tags?post=4496"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}