מתכון התקנה ל-Rails Girls

זמן בישול: 5 דקות מעשי / 15-30 דקות המתנה

כדי לבנות אפליקציות ודברים אחרים ב-Ruby on Rails, נצטרך להתקין תוכנות וסביבת פיתוח על המחשב שלך.

עקבי אחר ההוראות עבור מערכת ההפעלה שלך. אם נתקלת בבעיה - אל תבהלי. הודעי לנו על כך בארוע ונוכל לפתור את זה יחד.


התקנה על OS X

1. בואי נבדוק את הגרסא של מערכת ההפעלה.

לחצי על תפריט ה-Apple ובחרי About this Mac.

Apple menu

2. בחלון הזה תמצאי את הגרסא של מערכת ההפעלה

אם הגרסא שלך מתחילה ב 10.6, 10.7, 10.8, 10.9, 10.10, או 10.11 אז המדריך הזה בשבילך. אם יש לך גרסא אחרת, אז נעזור לך להתקין בארוע.

About this Mac dialog

3א. אם גרסאת ה- OS X שלך היא 10.9 או מעל:

אם הגרסא שלך היא 10.9 ומעלה, עקבי אחרי השלבים הבאים. אנחנו נתקין homebrew ו- rbenv.

3א1. התקיני כלי Command line דרך הטרמינל:

xcode-select --install

3א2. התקיני Homebrew:

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

3א3. התקיני rbenv:

brew update
brew install rbenv ruby-build
echo 'if which rbenv > /dev/null; then eval "$(rbenv init -)"; fi' >> ~/.bash_profile
source ~/.bash_profile

3א4. התקיני Ruby עם rbenv:

את יכולה למצוא מה הגרסא הכי חדשה של Ruby עם הפקודה “rbenv install -l”.

rbenv install 2.2.3

אם קיבלת שגיאת “OpenSSL::SSL::SSLError: … : certificate verify failed”, נסי בדרך הבאה:

brew install curl-ca-bundle
cp /usr/local/opt/curl-ca-bundle/share/ca-bundle.crt `ruby -ropenssl -e 'puts OpenSSL::X509::DEFAULT_CERT_FILE'`

3א5. הגדירי את ברירת המחדל של Ruby:

rbenv global 2.2.3

3א6. התקיני Rails:

gem i rails --no-ri --no-rdoc

3ב. אם גרסאת ה- OS X שלך היא 10.6, 10.7 או 10.8:

הורידי RailsInstaller עבור גרסאת ה- OS X שלך:

לחיצה כפולה על הקובץ על הקובץ שירד יפתח אותו בתיקייה הנוכחית. לחצי לחיצה כפולה על הקובץ החדש ‘RailsInstaller-1.0.4-osx-10.7.app’ או ‘RailsInstaller-1.0.4-osx-10.6.app’ ופעלי לפי ההוראות. זה יפתח קובץ README עם ‘Rails Installer OS X’ בראש הדף. אנא התעלמי מההוראות בקובץ הזה.

3ג. בדקי שהכל עובד:

אם גרסאת ה - Rails לא העדכנית ביותר, את יכולה להעדכן אותה בעזרת הפקודה הבאה בטרמינל:

gem update rails --no-ri --no-rdoc

בדקי כי הכל עובד באופן תקין ע״י הרצה של פקודת יצירת האפליקציה:

rails new railsgirls
cd railsgirls
rails server

את אמורה לראות בטרמינל את הדבר הבא:

=> Booting WEBrick
 => Rails 4.1.5 application starting in development on http://0.0.0.0:3000
 => Run ``rails server`` -h for more startup options
 => Notice: server is listening on all interfaces (0.0.0.0). Consider using 127.0.0.1 (--binding option)
 => Ctrl-C to shutdown server
 [2015-04-05 15:54:41] INFO  WEBrick 1.3.1
 [2015-04-05 15:54:41] INFO  ruby 2.1.2 (2014-05-08) [x86_64-darwin13.0]
 [2015-04-05 15:54:41] INFO  WEBrick::HTTPServer#start: pid=25594 port=3000

אם ראית את השורות הללו - ברכותינו! שרת ה-rails שלך למעלה. כדי להמשיך ולכתוב פקודות בחלון הטרמינל תצטרכי להוריד אותו ע״י לחיצה על ctrl+c.

כעת עליך למחוק את האפליקצייה שיצרת, מאחר ואנחנו ניצור אותה מחדש מחר בסדנה:

cd ..
rm -r railsgirls

4. התקיני עורך טקסט לעריכת קבצי האפליקציה

אנחנו ממליצים להוריד עורך טקסט בשם Atom לצורך הסדנא.

5. עדכני את הדפדפן

פתחי whatbrowser.org ועדכני את הדפדפן אם אין לך את הגרסא המעודכנת ביותר.

אנא קראי לאחד המדריכים כדי לוודא שהכל הותקן אצלך באופן תקין :)


התקנה על Windows

1. התקיני Rails

הורידי RailsInstaller והריצי אותו. עברי את ההתקנה עם הגדרות ברירת המחדל.

1.1 אפשרי העתק-הדבק בטרמינל

פתחי את Command Prompt with Ruby on Rails

אם יש לך windows 10:
לחצי עם לחצן ימני על שורת הכותרת של החלון, ובחרי ב-properties. בחלון שנפתח, בחרי בלשונית experimental. לאחר מכן סמני את “Enable new Ctrl key shortcuts” (יתכן שתצטרכי לסמן קודם את “Enable experimental console features”).

אם יש לך גירסת windows אחרת:
כדי להדביק טקסט בחלון הטרמינל, תצטרכי להשתמש בעכבר (לחצן ימני על החלון –> paste)

1.2 התקיני ריילס

ב-Command Prompt with Ruby on Rails הריצי את הפקודה הבאה:

rails -v

אם גרסאת ה Rails היא פחות מ- 4, עדכני אותה עם הפקודה הבאה:

gem update rails --no-ri --no-rdoc

בדקי כי הכל עובד באופן תקין ע״י הרצה של פקודת יצירת האפליקציה:

rails new railsgirls
cd railsgirls
rails server

את אמורה לראות בטרמינל את הדבר הבא:

=> Booting WEBrick
 => Rails 3.2.13 application starting in development on http://0.0.0.0:3000
 => Call with -d to detach
 => Ctrl-C to shutdown server
 [2015-04-05 16:12:06] INFO  WEBrick 1.3.1
 [2015-04-05 16:12:06] INFO  ruby 1.9.3 (2013-02-22) [i386-mingw32]
 [2015-04-05 16:12:06] INFO  WEBrick::HTTPServer#start: pid=7912 port=3000

אם ראית את השורות הללו - ברכותינו! שרת ה-rails שלך למעלה. כדי להמשיך ולכתוב פקודות בחלון הטרמינל תצטרכי להוריד אותו ע״י לחיצה על ctrl+c.

כעת עליך למחוק את האפליקצייה שיצרת, מאחר ואנחנו ניצור אותה מחדש מחר בסדנה:

cd ..
rd /s railsgirls

בעיות אפשריות

שגיאת Gem::RemoteFetcher

אם קיבלת את השגיאה הבא בעת ריצה של rails new railsgirls או gem update rails:

Gem::RemoteFetcher::FetchError: SSL_connect returned=1 errno=0 state=SSLv3 read
server certificate B: certificate verify failed (https://rubygems.org/gems/i18n-
0.6.11.gem)

זה אומר שיש לך גרסא ישנה של Rubygems ואת תצטרכי תחילה ידנית לבדוק מהי הגרסא של Rubygems שיש לך:

gem -v

אם הגרסא היא פחות מ2.2.3 את תצטרכי לעדכן אותה ידנית:

קודם כל הורידי אתruby-gems-update gem. תעבירי את הקובץ לc:\\rubygems-update-2.2.3.gem והריצי:

gem install --local c:\\rubygems-update-2.2.3.gem
update_rubygems --no-ri --no-rdoc
gem uninstall rubygems-update -x

בדקי את הגרסא של ה- Rubygems:

gem -v

וודאי כי כעת הגרסא היא מעל 2.2.3. הריצי את הפקודות הקודמות שוב אם הם נכשלו.

שגיאת ‘x64_mingw’ is not a valid platform`

לפעמים מקבלים את השגיאה הבאה בעת ריצה שלrails server : 'x64_mingw' is not a valid platform אם קיבלת את השגיאה הזאת לאחר שימוש ב- RailsInstaller את צריכה לעשות שינוי קטן לקובץ Gemfile:

הסתכלי לתחתית הקובץ. את בטח תראי משהו כזה בשורות האחרונות של הקובץ:

gem 'tzinfo-data', platforms: [:mingw, :mswin, :x64_mingw]

אם יש לך את השורה הזאת יחד עם :x64_mingw , אז מחקי את :x64_mingw. בסוף זה אמור להיראות כך:

'tzinfo-data', platforms: [:mingw, :mswin]

לאחר שעשית את זה, תריצי בטרמינל את הפקודה bundle update.

2. התקיני עורך טקסט לעריכת קבצי האפליקציה

אם את משתמשת ב Windows Vista או בגרסאות ישנות יותר, הורידי את העורך של Sublime Text 2.

אם יש לך גרסת windows מתקדמת (7 ויותר) אנחנו ממליצים להוריד עורך טקסט בשם Atom לצורך הסדנא.

3.עדכני את הדפדפן

אם את משתמשת ב- Internet Explorer, אז אנחנו ממליצות להתקין Firefox או Google Chrome.

פתחי whatbrowser.org ועדכני את הדפדפן אם אין לך את הגרסא המעודכנת ביותר.

4. התקיני Node

כדאי להתקין Node כיוון שזה מונע בעיות עתידיות של אשר קורות לעיתים ניתן לקרוא על כך יותר כאן.

לכי ל https://nodejs.org/ והתקיני Node.

בדקי את הגרסא של Node:

node --version

וודאי כי הגרסא היא מעל 0.12.

אנא קראי לאחד המדריכים כדי לוודא שהכל הותקן אצלך באופן תקין :)


התקנה על Linux

1. התקנה של Rails

בשביל להתקין את סביבת הפיתוח אל Ruby on Rails כל מה שצריך לעשות זה להעתיק את השורה הבאה לגרסאת ה- Linux שיש לך (Ubuntu או Fedora), להעביר אותה לטרמינל, וללחוץ Enter. תהני משורות הטקסט שעפות לך על המסך. זה יכול לקחת קצת זמן - קחי משקה לפני שהתהליך מתחיל :)

 עבור Ubuntu:

bash < <(curl -sL https://raw.github.com/railsgirls/installation-scripts/master/rails-install-ubuntu.sh)

אם את מתכננת להשתמש בהתקנות RVM עם gnome-terminal, את תצטרכי לשנות את הגדרות ברירת המחדל לפני שתוכלי לראות את גרסאות ה- Ruby on Rails הנכונות. גלי איך כאן:RVM documentation.

 עבור Fedora:

bash < <(curl -sL https://raw.github.com/railsgirls/installation-scripts/master/rails-install-fedora.sh)

בדקי שהכל עובד תקין ע״י הרצה של השורות הבאות:

rails new railsgirls
cd railsgirls
rails server

את אמורה לראות בטרמינל את הדבר הבא:

=> Booting WEBrick
 => Rails 4.1.5 application starting in development on http://0.0.0.0:3000
 => Run ``rails server`` -h for more startup options
 => Notice: server is listening on all interfaces (0.0.0.0). Consider using 127.0.0.1 (--binding option)
 => Ctrl-C to shutdown server
 [2015-04-05 15:54:41] INFO  WEBrick 1.3.1
 [2015-04-05 15:54:41] INFO  ruby 2.1.2 (2014-05-08) [x86_64-darwin13.0]
 [2015-04-05 15:54:41] INFO  WEBrick::HTTPServer#start: pid=25594 port=3000

לאחר שראית את השורות הללו בטרמינל, את יכולה למחוק את האפליקציה ע״י הרצה של הפקודה הבאה בטרמינל:

cd ..
rd -r railsgirls

2. התקיני עורך טקסט לעריכת קבצי האפליקציה

 עבור Ubuntu:

ניתן להוריד Atom רק אם יש לך גרסת 64 ביט.

הורידי Atom והתקיני אותו:

sudo dpkg --install atom-amd64.deb

עבור Fedora (גרסא 21 או מתחת), CentOS או Red Hat:

ניתן להוריד Atom רק אם יש לך גרסת 64 ביט.

הורידי Atom והתקיני אותו:

sudo yum localinstall atom.x86_64.rpm

עבור שאר מערכות ההפעלה של Linux:

אנחנו ממליצות להוריד את Sublime

Sublime Text 2.

3. עדכני את הדפדפן

פתחי whatbrowser.org ועדכני את הדפדפן אם אין לך את הגרסא המעודכנת ביותר.

אנא קראי לאחד המדריכים כדי לוודא שהכל הותקן אצלך באופן תקין :)


Using a Cloud Service

Instead of installing Ruby on Rails and an editor on your computer, you can use a webservice for development. All you need is a browser and an internet connection. This guide explains how to get started with nitrous.io. If you’re using a different service, they may use a different wording - e.g. ‘workspace’ instead of ‘box’, but the process is usually pretty similar.

1. Update your browser

If you use Internet Explorer, we recommend installing Firefox or Google Chrome.

Open whatbrowser.org and update your browser if you don’t have the latest version.

2. Create an account

Go to https://nitrous.io and signup.

3. Setup a development box / workspace for ruby on rails

4. Find and restart your development box

5. Coding with your development box