การรัน Eclipse

หลังจากการติดตั้ง Eclipse SDK ในไดเร็กทอรี คุณสามารถเริ่มต้น Workbench โดยการรันโปรแกรมของ Eclipse ที่มากับรีลีส (คุณยังคงต้องใช้ Java SE 5 JRE ซึ่งไม่ได้รวมมากับ Eclipse SDK). บน Windows, ไฟล์เรียกทำงานชื่อ eclipse.exe และอยู่ในไดเร็กทอรีย่อย eclipse ของการติดตั้ง ถ้า ติดตั้งที่ c:\eclipse-SDK-4.1-win32 ไฟล์เรียกทำงานคือ c:\eclipse-SDK-4.1-win32\eclipse\eclipse.exe. หมายเหตุ: เซ็ตอัพบนสภาวะแวดล้อมการปฏิบัติการอื่นส่วนใหญ่จะเหมือนกัน คำสั่ง พิเศษสำหรับ Mac OS X ถูกแสดง ด้านล่าง

การจัดสรรหน่วยความจำที่เพียงพอและการแก้ไข OutOfMemoryErrors

โดยดีฟอลต์ Eclipse จะจัดสรรได้มากถึง 384 เมกะไบต์จากหน่วยความจำฮีปของ Java ซึ่งควร เพียงพอสำหรับงานการพัฒนาทั่วไปทั้งหมด อย่างไรก็ตาม ขึ้นอยู่กับ JRE ที่คุณรันอยู่ จำนวนของปลั๊กอินเพิ่มเติมที่คุณใช้ และ จำนวนของไฟล์ที่คุณจะทำงานด้วย คุณอาจต้องเพิ่มจำนวนค่านี้ Eclipse ให้คุณส่งอาร์กิวเมนต์โดยตรงไปที่ Java VM โดยใช้อาร์กิวเมนต์บรรทัดรับคำสั่ง -vmargs ที่ต้องติดตามอาร์กิวเมนต์จำเพาะ Eclipse อื่นทั้งหมด ดังนั้น เพื่อเพิ่มหน่วยความจำฮีปที่ใช้ได้ โดยปกติคุณจะใช้:

eclipse -vmargs -Xmx<memory size>

ด้วยชุดค่า <memory size> ที่มากกว่า "384M" (384 เมกะไบต์ -- ดีฟอลต์)

เมื่อใช้ Oracle (Sun) VM คุณยังอาจจำเป็นต้องเพิ่มขนาดของหน่วยความจำ การสร้างถาวร ค่าสูงสุดดีฟอลต์คือ 64 เมกะไบต์ แต่อาจจำเป็นต้อง ใช้ค่ามากกว่าขึ้นกับคอนฟิกูเรชันและการใช้ปลั๊กอินของคุณ เมื่อ VM ใช้ หน่วยความจำการสร้างถาวรหมด อาจหยุดทำงานหรือค้างระหว่างการโหลดคลาส ความล้มเหลวนี้ไม่พบบ่อยเมื่อใช้ Sun JRE เวอร์ชัน 1.5.0_07 หรือสูงกว่า ขนาดการสร้างถาวรสูงสุดถูกเพิ่มโดยใช้อาร์กิวเมนต์ -XX:MaxPermSize=<memory size> :

eclipse -vmargs -XX:MaxPermSize=<memory size>

อาร์กิวเมนต์นี้อาจใช้ไม่ได้สำหรับเวอร์ชันและแพลตฟอร์ม VM ทั้งหมด; โปรดดูที่เอกสารคู่มือ VM ของคุณ สำหรับรายละเอียดเพิ่มเติม

โปรดสังเกตว่าการตั้งค่าขนาดหน่วยความจำมากกว่าจำนวนหน่วยความจำฟิสิคัลที่มีอยู่ ในเครื่องของคุณจะทำให้ Java "thrash" ขณะที่คัดลอกอ็อบเจ็กต์ ไปมา ไปที่หน่วยความจำเสมือน ซึ่งจะลดประสิทธิภาพการทำงานของคุณอย่างมาก

การเลือกเวิร์กสเปซ

เมื่อ Workbench ถูกเรียกใช้ สิ่งแรกที่คุณเห็นคือไดอะล็อก ที่ให้คุณเลือกตำแหน่งเวิร์กสเปซ เวิร์กสเปซ เป็นไดเร็กทอรีที่จะเก็บงานของคุณ ถ้าคุณไม่ระบุเป็นอย่างอื่น Eclipse จะสร้างเวิร์กสเปซในไดเร็กทอรีผู้ใช้ ของคุณ ไดเร็กทอรีเวิร์กสเปซนี้ถูกใช้เป็นพื้นที่เนื้อหาดีฟอลต์สำหรับโปรเจ็กต์ของคุณ เช่นเดียวกับการเก็บข้อมูลเมตาที่จำเป็น สำหรับการติดตั้งเวิร์กสเปซที่แบ่งใช้หรือหลายเวิร์กสเปซ คุณต้องระบุตำแหน่งสำหรับเวิร์กสเปซของคุณโดยใช้ ไดอะล็อก (หรือผ่านอาร์กิวเมนต์บรรทัดรับคำสั่ง "-data")

การระบุ Java virtual machine

นี่เป็นบรรทัดรับคำสั่ง Eclipse ปกติ: 

eclipse -vm c:\jdk5u22\jre\bin\javaw

คำแนะนำ: โดยทั่วไปเป็นความคิดที่ดีในการระบุให้ชัดเจนถึง Java VM ที่ จะใช้เมื่อรัน Eclipse ซึ่งทำได้ด้วยอาร์กิวเมนต์บรรทัดรับคำสั่ง "-vm" ตามที่แสดงด้านบน ถ้าคุณไม่ใช้ "-vm", Eclipse จะค้นหาพาธ O/S เมื่อคุณติดตั้งผลิตภัณฑ์จาก Java อื่นๆ ซึ่งอาจเปลี่ยนพาธของคุณและอาจมีผลให้ Java VM ที่ต่างกันถูกใช้ เมื่อคุณเรียกใช้ Eclipse ในครั้งถัดไป

เมื่อต้องการสร้างช็อตคัต Windows ให้กับ Eclipse ที่ติดตั้ง:

  1. นำทางไปที่ eclipse.exe ใน Windows Explorer และใช้ Create Shortcut บนเมนูเนื้อหา
  2. เลือกช็อตคัตและแก้ไขคุณสมบัติ ในเป้าหมาย: ฟิลด์ผนวก อาร์กิวเมนต์บรรทัดรับคำสั่ง

การเปิดช็อตคัตนี้เรียกใช้ Eclipse (คุณสามารถลากช็อตคัตไปที่ Windows Desktop ถ้าคุณต้องการให้เข้าถึงได้ง่าย)

Mac OS X

บน Mac OS X คุณเริ่มต้น Eclipse โดยดับเบิลคลิกแอ็พพลิเคชัน Eclipse ถ้าคุณจำเป็นต้อง ส่งอาร์กิวเมนต์ไปที่ Eclipse, คุณจะต้องแก้ไขไฟล์ eclipse.ini ในบันเดิลแอ็พพลิเคชัน Eclipse: เลือกไอคอนบันเดิลแอ็พพลิเคชัน Eclipse ขณะกดคีย์ Control ค้างไว้ นี่จะแสดงเมนูป็อปอัพ เลือก "Show Package Contents" ในเมนูป็อปอัพ ค้นหาไฟล์ eclipse.ini ในโฟลเดอร์ย่อย Contents/MacOS และเปิดด้วยเท็กซ์เอดิเตอร์โปรดของคุณเพื่อแก้ไขอ็อพชันบรรทัดรับคำสั่ง

บน MacOS X คุณสามารถเรียกใช้โปรแกรม UI ได้มากกว่าหนึ่งครั้งถ้าคุณมีสำเนา ของโปรแกรมแยกกันบนดิสก์ เหตุผลสำหรับลักษณะการทำงานนี้คือทุกแอ็พพลิเคชัน UI บน Mac สามารถเปิดได้หลายเอกสาร ดังนั้นโดยทั่วไปไม่จำเป็นต้องเปิด โปรแกรมสองครั้ง เนื่องจาก Eclipse ไม่สามารถเปิดมากกว่าหนึ่งเวิร์กสเปซ ซึ่งหมายความว่าคุณต้องสร้าง สำเนาของการติดตั้ง Eclipse ถ้าคุณต้องการเปิดมากกว่าหนึ่งเวิร์กสเปซ ในเวลาเดียวกัน (จุดบกพร่อง 139319)

ถ้าคุณต้องการเรียกใช้ Eclipse จากบรรทัดรับคำสั่ง คุณสามารถใช้ลิงก์เชิงสัญลักษณ์ "eclipse" ใน โฟลเดอร์ eclipse ระดับบนสุด ซึ่งจะอ้างอิงถึงโปรแกรมของ eclipse ในบันเดิลแอ็พพลิเคชันและรับ อาร์กิวเมนต์เหมือนกับ "eclipse.exe" บนแพลตฟอร์มอื่น

บน Mac OS X 10.4 และสูงกว่า คุณอาจสังเกตการทำงานได้ช้า เมื่อทำงานกับรีซอร์ส ที่มากขึ้น ถ้าคุณให้ Spotlight ทำดัชนีเวิร์กสเปซของคุณ เพื่อป้องกันปัญหานี้ ให้เริ่มต้น System Preferences, เลือกไอคอน Spotlight แล้วเลือกแท็บ Privacy แล้วคลิกปุ่ม Add ("+") และค้นหาไดเร็กทอรีเวิร์กสเปซของคุณในไดอะล็อกที่แสดง

การติดตั้งที่แบ่งใช้

ความเร็วในการเริ่มต้นของการติดตั้งที่แบ่งใช้ถูกเพิ่มได้ ถ้าข้อมูลแคชที่ถูกต้องถูกเก็บใน พื้นที่ติดตั้ง เพื่อดำเนินการดังกล่าว หลังจากการคลายชุดของ Eclipse ให้รัน Eclipse หนึ่งครั้งด้วยอ็อพชัน "-initialize" จากแอคเคาต์ที่มีการเข้าถึงเขียนข้อมูลกับไดเร็กทอรีการติดตั้ง

หัวข้อระดับสูงในการรัน Eclipse

โปรแกรมของ Eclipse และตัวแพลตฟอร์มเองเสนออ็อพชันการเรียกใช้ ที่น่าสนใจต่อผู้พัฒนาหรือผู้ที่ดีบักส่วนต่างๆ ของ Eclipse นี่เป็น รายการของอ็อพชันที่ใช้ทั่วไป สำหรับรายการสมบูรณ์โปรดดูที่หน้าอ็อพชันรันไทม์ของ Eclipse ในคู่มือผู้พัฒนาปลั๊กอินของแพลตฟอร์ม รูปแบบทั่วไปของการรัน โปรแกรมของ Eclipse คือ:

eclipse [platform options] [-vmargs [Java VM arguments]]
พารามิเตอร์เริ่มทำงาน Eclipse
คำสั่ง รายละเอียด ตั้งแต่
-arch architecture
กำหนดสถาปัตยกรรมตัวประมวลผลที่แพลตฟอร์ม Eclipse รันอยู่ แพลตฟอร์ม Eclipse โดยทั่วไปคำนวณการตั้งค่าที่เหมาะสมที่สุด โดยใช้ค่าการควบคุมของคุณสมบัติ Java os.arch ถ้าถูกระบุที่นี่ นี่จะเป็นค่าที่แพลตฟอร์ม Eclipse ใช้ ค่า ที่ระบุที่นี่ใช้ได้กับปลั๊กอินเช่น Platform.getOSArch() ค่าตัวอย่าง: "x86", "sparc", "PA-RISC", "ppc". 2.0
-application applicationId
แอ็พพลิเคชันที่จะรัน แอ็พพลิเคชันถูกประกาศตามปลั๊กอิน ที่กำหนดส่วนขยายให้กับ org.eclipse.core.runtime.applications extension point โดยปกติอาร์กิวเมนต์นี้ไม่จำเป็น ถ้าระบุ ค่า จะแทนที่ค่าที่ระบุโดยคอนฟิกูเรชัน ถ้าไม่ระบุ Eclipse Workbench จะถูกรัน 1.0
-clean
Cleans ข้อมูลที่แคชที่ใช้โดยเฟรมเวิร์ก OSGi และรันไทม์ Eclipse ให้ลองรัน Eclipse หนึ่งครั้งด้วยอ็อพชันนี้ ถ้าคุณพบข้อผิดพลาดของการเริ่มทำงาน หลังการติดตั้งอัพเดต หรือโดยใช้คอนฟิกูเรชันที่แบ่งใช้ 3.0
-configuration configURL
ตำแหน่งสำหรับไฟล์คอนฟิกูเรชันแพลตฟอร์ม Eclipse ที่แสดงเป็น URL ไฟล์คอนฟิกูเรชันกำหนดตำแหน่งของ แพลตฟอร์ม Eclipse ชุดของปลั๊กอินที่ใช้ได้และคุณลักษณะหลัก โปรดสังเกตว่า URL สัมพัทธ์ใช้ไม่ได้ ไฟล์คอนฟิกูเรชันถูกเขียน ให้กับตำแหน่งนี้ เมื่อแพลตฟอร์ม Eclipse ถูกติดตั้งหรืออัพเดต 2.0
-consolelog
มิเรอร์บันทึกข้อผิดพลาดของแพลตฟอร์ม Eclipse ไปที่คอนโซล ที่ใช้เพื่อรัน Eclipse มีประโยชน์เมื่อรวมกับ -debug 1.0
-data workspacePath
พาธของเวิร์กสเปซที่จะรันแพลตฟอร์ม Eclipse ตำแหน่งเวิร์กสเปซเป็นตำแหน่งดีฟอลต์สำหรับโปรเจ็กต์เช่นกัน พาธสัมพัทธ์ ถูกแปลสัมพัทธ์กับไดเร็กทอรีที่ Eclipse ถูก เริ่มทำงาน 1.0
-debug [optionsFile]
รันแพลตฟอร์มในโหมดดีบักและโหลดอ็อพชันดีบัก จากไฟล์ที่ตำแหน่งที่กำหนด ถ้าระบุ ไฟล์นี้ระบุ จุดดีบักที่ใช้ได้สำหรับปลั๊กอินและถูกเปิดใช้งาน หรือไม่ ถ้าตำแหน่งไฟล์ไม่ถูกกำหนด แพลตฟอร์มจะค้นหา ในไดเร็กทอรีที่ eclipse ถูกเริ่มต้น เพื่อหาไฟล์ชื่อ ".options" ทั้ง URL และพาธระบบไฟล์ใช้เป็นตำแหน่งไฟล์ได้ 1.0
-dev [classpathEntries]
รันแพลตฟอร์มในโหมดการพัฒนา รายการ classpath ทางเลือก (รายการที่คั่นด้วยคอมมา) ถูกเพิ่มให้กับ classpath รันไทม์ของ แต่ละปลั๊กอิน ตัวอย่างเช่น เมื่อ workspace มีปลั๊กอินที่ถูก พัฒนา การระบุ -dev bin เพิ่มรายการ classpath สำหรับ แต่ละไดเร็กทอรีของโปรเจ็กต์ปลั๊กอินชื่อ bin เพื่อให้พบไฟล์ คลาสที่ถูกสร้างใหม่ได้ที่นี่ รายการ classpath ที่ซ้ำซ้อนหรือไม่มีอยู่ จะถูกเอาออก 1.0
-initialize
เตรียมข้อมูลเบื้องต้นคอนฟิกูเรชันที่ถูกรัน รันไทม์ทั้งหมดที่เชื่อมโยงกับ โครงสร้างข้อมูลและแคชจะถูกรีเฟรช มีประโยชน์กับการติดตั้งที่แบ่งใช้: รัน Eclipse หนึ่งครั้ง ด้วยอ็อพชันนี้จากแอคเคาต์ที่มี write privileges จะเพิ่มประสิทธิภาพใน การเริ่มทำงาน 3.0
-keyring keyringFilePath
ตำแหน่งของฐานข้อมูลการอนุญาต (หรือไฟล์ "key ring" ) บนดิสก์ อาร์กิวเมนต์นี้ต้องถูกใช้ร่วมกับ อ็อพชัน -password พาธสัมพัทธ์ถูกแปลสัมพัทธ์กับไดเร็กทอรีที่ Eclipse ถูก เริ่มทำงาน 1.0
-nl locale
กำหนดชื่อของโลแคลที่แพลตฟอร์ม Eclipse รันอยู่ คำนวณแพลตฟอร์ม Eclipse โดยทั่วไปคำนวณการตั้งค่าที่เหมาะสมที่สุด โดยอัตโนมัติ ถ้าถูกระบุที่นี่ นี่จะเป็นค่าที่แพลตฟอร์ม Eclipse ใช้ ค่าที่ระบุที่นี่ใช้ได้กับปลั๊กอินเช่น Platform.getNL() ค่าตัวอย่าง: "en_US" and "fr_FR_EURO" 2.0
-nosplash
รันแพลตฟอร์มโดยไม่ใส่หน้าจอเริ่มต้น 1.0
-os operatingSystem
กำหนดระบบปฏิบัติการที่แพลตฟอร์ม Eclipse รันอยู่ แพลตฟอร์ม Eclipse โดยทั่วไปคำนวณการตั้งค่าที่เหมาะสมที่สุด โดยใช้ค่าการควบคุมของคุณสมบัติ Java os.name ถ้าถูกระบุ ที่นี่ นี่จะเป็นค่าที่แพลตฟอร์ม Eclipse ใช้ ค่าที่ระบุที่นี่ ใช้ได้กับปลั๊กอินเป็น Platform.getOS() และใช้เพื่อหาค่า การปรากฎของตัวแปร $os$ ในพาธที่กล่าวถึงใน ไฟล์ manifest ของปลั๊กอิน ค่าตัวอย่าง: "win32", "linux", "hpux", "solaris", "aix" 1.0
-password password
รหัสผ่านสำหรับฐานข้อมูลการอนุญาต ใช้ร่วมกับ อ็อพชัน -keyring 1.0
-perspective perspectiveId
เปอร์สเปคทีฟเพื่อเปิดในหน้าต่าง workbench แอ็คทีฟเมื่อ เริ่มทำงาน ถ้าไม่ระบุพารามิเตอร์นี้ เปอร์สเปคทีฟที่ถูก แอ็คทีฟเมื่อปิดระบบจะถูกเปิด 1.0
-plugincustomization
	  propertiesFile
ตำแหน่งของไฟล์คุณสมบัติที่มีค่ากำหนดดีฟอลต์ สำหรับการกำหนดค่าตามความชอบปลั๊กอิน ค่ากำหนดดีฟอลต์เหล่านี้แทนที่ค่ากำหนดดีฟอลต์ ที่ระบุในคุณลักษณะหลัก พาธสัมพัทธ์ถูกแปลสัมพัทธ์กับไดเร็กทอรีที่ eclipse ถูก เริ่มทำงาน 2.0
-product productId
ID ของผลิตภัณฑ์ที่รัน ผลิตภัณฑ์กำหนดลักษณะอินสแตนซ์ที่เรียกใช้ ของ Eclipse และกำหนดข้อมูลการกำหนดผลิตภัณฑ์เอง ที่ใช้ ซึ่งแทนที่ -feature ที่ยังคงสนับสนุนอยู่เพื่อ ความเข้ากันได้ 3.0
-refresh 
อ็อพชันสำหรับทำการรีเฟรชโกลบอลของ เวิร์กสเปซเมื่อเริ่มทำงาน นี่จะรับการเปลี่ยนแปลงที่ถูกทำขึ้นใน ระบบไฟล์ ตั้งแต่แพลตฟอร์มรันครั้งล่าสุด 1.0
-showlocation [workspaceName]
อ็อพชันสำหรับการแสดงตำแหน่งของเวิร์กสเปซ ในแถบชื่อเรื่องหน้าต่าง ในรีลีส 2.0 อ็อพชันนี้ทำงานร่วมกับ อาร์กิวเมนต์บรรทัดรับคำสั่ง -data เท่านั้น ใน 3.2, อาร์กิวเมนต์ชื่อเวิร์กสเปซทางเลือกถูกเพิ่มซึ่งแสดงชื่อที่จัดเตรียมในแถบชื่อหน้าต่างแทนตำแหน่งของเวิร์กสเปซ 2.0
-vm vmPath
ตำแหน่งของ Java Runtime Environment (JRE) ที่จะใช้เพื่อ รันแพลตฟอร์ม Eclipse ถ้าไม่ระบุ โปรแกรมเรียกใช้งานจะพยายามค้นหา JRE ขั้นแรกจะค้นหาไดเร็กทอรีชื่อ jre เป็น sibling ของโปรแกรม Eclipse แล้วค้นหาที่พาธระบบปฏิบัติการ พาธสัมพัทธ์ถูกแปลสัมพัทธ์กับไดเร็กทอรีที่ eclipse ถูก เริ่มทำงาน 1.0
-vmargs args
เมื่อส่งไปที่ Eclipse อ็อพชันนี้จะถูกใช้เพื่อกำหนดเองการดำเนินการ ของ Java VM ที่ใช้เพื่อรัน Eclipse ถ้าระบุ อ็อพชันนี้ต้องอยู่ ท้ายบรรทัดรับคำสั่ง อาร์กิวเมนต์ที่กำหนดขึ้นกับ VM ที่ถูกรัน 1.0

อาร์กิวเมนต์ทั้งหมดที่ตามด้วยรายการ (แต่ไม่รวม) -vmargs ถูกส่ง โดยตรงผ่าน Java VM ที่ระบุเป็นอาร์กิวเมนต์เครื่องเสมือน (นั่นคือ ก่อนที่คลาสจะรัน) หมายเหตุ: ถ้าอาร์กิวเมนต์เริ่มทำงาน Eclipse เช่น -data, ถูกจัดเตรียมหลังจากอาร์กิวเมนต์ Java vm (-vmargs), Eclipse จะไม่เริ่มต้นและคุณจะได้รับ ข้อผิดพลาด "JVM terminated. Exit code=1"