ข้ามไปยังเนื้อหา

การติดตั้ง

สิ่งที่ต้องมี

หัวข้อที่มีชื่อว่า “สิ่งที่ต้องมี”
  • Git สำหรับดาวน์โหลดโค้ด
  • rustup ตัวติดตั้ง Rust รีโพซิทอรีกำหนดเวอร์ชัน Rust ไว้ที่ 1.95.0 ใน rust-toolchain.toml และ rustup จะติดตั้งเวอร์ชันนั้นให้ในการบิลด์ครั้งแรก
  • ทูลเชน C สำหรับการลิงก์: Xcode Command Line Tools บน macOS, Visual Studio C++ build tools บน Windows หรือ GCC บน Linux
  • ไดรเวอร์กราฟิกที่รองรับ OpenGL แอปเดสก์ท็อปวาดภาพด้วยแบ็กเอนด์ glow ของ egui

บิลด์จากซอร์สโค้ด

หัวข้อที่มีชื่อว่า “บิลด์จากซอร์สโค้ด”

เลือกระบบของคุณ แท็บของระบบที่คุณกำลังใช้อยู่จะเปิดขึ้นก่อน

  1. ติดตั้ง Xcode Command Line Tools ซึ่งมีตัวลิงก์ (linker) มาให้:

    Terminal window
    xcode-select --install

  2. ติดตั้ง rustup (จาก rustup.rs):

    Terminal window
    curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

  3. ดาวน์โหลดโค้ดแล้วบิลด์:

    Terminal window
    git clone https://github.com/aprajnaparamita/larrygram.git
    cd larrygram
    cargo build --release -p larrygram

  4. เปิด Larrygram:

    Terminal window
    ./target/release/larrygram

การเปิดใช้ครั้งแรก

หัวข้อที่มีชื่อว่า “การเปิดใช้ครั้งแรก”

เมื่อเปิด Larrygram ครั้งแรก วิซาร์ดต้อนรับจะให้คุณเลือก Panel Modern หรือ Panel Classic กำลังพัฒนา หากคุณปิดวิซาร์ดไป Larrygram จะใช้ Panel Modern เปิดวิซาร์ดอีกครั้งได้จาก Help > Welcome

คุณยังเลือกเลย์เอาต์ได้ตอนเปิดแอป ค่าทั้งสี่แบบนี้จะมาพร้อม v1.0 alpha ส่วนบิลด์ปัจจุบันรับค่า 2016 และ 365

Terminal window
./target/release/larrygram --ui-layout panel-classic

ค่าที่ใช้ได้คือ panel-modern, panel-classic, panel-2016 และ panel-365 แฟล็กนี้มีผลเหนือค่าที่บันทึกไว้สำหรับการใช้งานครั้งนั้น

macOS Gatekeeper และ Windows SmartScreen

หัวข้อที่มีชื่อว่า “macOS Gatekeeper และ Windows SmartScreen”

บิลด์ที่คุณสร้างเองจะทำงานได้โดยไม่มีคำเตือน สำหรับไฟล์ของรุ่นเผยแพร่ในอนาคต ยังไม่ได้ตัดสินใจเรื่องการลงนามโค้ด (code signing) TODO(verify) หาก macOS แจ้งว่าแอป “cannot be opened” (เปิดไม่ได้) ให้กด Control ค้างแล้วคลิกแอปนั้นใน Finder แล้วเลือก Open หาก Windows SmartScreen แสดงข้อความ “Windows protected your PC” ให้เลือก More info แล้วเลือก Run anyway โดยทำเช่นนี้กับไฟล์ที่คุณดาวน์โหลดจากหน้ารุ่นเผยแพร่อย่างเป็นทางการเท่านั้น

อัปเดต

หัวข้อที่มีชื่อว่า “อัปเดต”

จากโฟลเดอร์ที่คุณโคลนไว้:

Terminal window
git pull
cargo build --release -p larrygram

ถอนการติดตั้ง

หัวข้อที่มีชื่อว่า “ถอนการติดตั้ง”
  1. ลบโฟลเดอร์ larrygram ที่คุณโคลนไว้
  2. หากต้องการ ให้ลบการตั้งค่าของคุณด้วย Larrygram เก็บการตั้งค่าไว้ในโฟลเดอร์ข้อมูลแอปของชุดเครื่องมือ eframe สำหรับ app id Larrygram TODO(verify) exact paths
  3. หากต้องการ ให้ลบ Rust ด้วยคำสั่ง rustup self uninstall

ตรวจสอบไฟล์ที่ดาวน์โหลด

หัวข้อที่มีชื่อว่า “ตรวจสอบไฟล์ที่ดาวน์โหลด”

แต่ละรุ่นจะเผยแพร่ค่า checksum SHA-256 นำ checksum ของไฟล์ที่คุณดาวน์โหลดมาเทียบกับค่าที่เผยแพร่ไว้:

Terminal window
shasum -a 256 <file>

บิลด์สำหรับเว็บ อยู่ในแผน

หัวข้อที่มีชื่อว่า “บิลด์สำหรับเว็บ ”

Larrygram บิลด์สำหรับเบราว์เซอร์ได้ด้วย (WebAssembly บิลด์ด้วย trunk) เวอร์ชันที่โฮสต์บน larrygram.org อยู่ในแผน หากต้องการรันบนเครื่องของคุณเอง:

Terminal window
cargo install trunk
cd apps/larrygram-web
trunk serve

ในเบราว์เซอร์ Open จะอัปโหลดไฟล์ และ Save จะดาวน์โหลดไฟล์

ข้อผิดพลาดที่พบบ่อย

หัวข้อที่มีชื่อว่า “ข้อผิดพลาดที่พบบ่อย”

toolchain '1.95.0' is not installed : รันคำสั่ง cargo ใดก็ได้ภายในรีโพซิทอรี rustup จะติดตั้งทูลเชนตามเวอร์ชันที่กำหนดไว้ หากไม่ติดตั้ง ให้รัน rustup toolchain install ในโฟลเดอร์รีโพซิทอรี

linker 'cc' not found หรือ link.exe not found : ติดตั้งทูลเชน C สำหรับระบบของคุณ (ดูสิ่งที่ต้องมี)

Linux: ข้อผิดพลาดเกี่ยวกับไลบรารี X11, Wayland หรือ xkbcommon : ติดตั้งแพ็กเกจสำหรับการพัฒนาที่ eframe ระบุไว้สำหรับดิสทริบิวชันของคุณ TODO(verify) package list

cargo xtask gate ล้มเหลวเพราะขาดเครื่องมือ : การตรวจแบบเต็มต้องใช้ cargo-deny, cargo-llvm-cov, ทูลเชน nightly ที่มี cargo-fuzz และ target wasm32-unknown-unknown ใช้ cargo xtask gate --quick เพื่อข้ามขั้นตอน coverage, wasm และ fuzz

หน้านี้แปลจากภาษาอังกฤษ หากพบส่วนที่อ่านแล้วไม่ถูกต้อง แจ้งให้เราทราบ