appstreamcli-compose - คู่มืออ้างอิง ตัวเลือก ตัวอย่างคำสั่ง

---

ชื่อ

appstreamcli-compose - เขียนแคตตาล็อกข้อมูลเมตาของ AppStream จากไดเร็กทอรีทรี

เรื่องย่อ

appstreamcli compose [COMMAND]

คำอธิบาย

หน้าคู่มือนี้มีเอกสารคำสั่ง appstreamcli เขียน โดยสังเขป

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

เพื่อให้คำสั่ง appstreamcli เขียน ใช้งานได้ คุณอาจต้องติดตั้งโมดูลเขียนเพิ่มเติมสำหรับ appstreamcli ก่อน

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับโครงการ AppStream และองค์ประกอบอื่นๆ ที่เป็นส่วนหนึ่งของโครงการ โปรดดูที่หน้า AppStream ที่ Freedesktop.org[1]

ตัวเลือก

ไดเรกทอรีแหล่งที่มา

รายการไดเร็กทอรีที่ต้องประมวลผลต้องระบุเป็นพารามิเตอร์ตำแหน่ง ข้อมูลจากไดเร็กทอรีทั้งหมดจะรวมกันเป็นเนมสเปซเอาต์พุตเดียว

--origin NAME

ตั้งค่าตัวระบุที่มาของข้อมูล AppStream นี่อาจเป็นค่าเช่น "debian-unstable-main" หรือ "flathub"

--result-root DIR

ตั้งค่าไดเร็กทอรีที่ส่งออกเอาต์พุตที่สร้างทั้งหมดซึ่งปรับใช้กับเครื่องผู้ใช้ หากไม่ได้ตั้งค่าพารามิเตอร์นี้ และเรามีเพียงไดเร็กทอรีเดียวที่ต้องดำเนินการ เราจะใช้ไดเร็กทอรีนั้นเป็นพาธเอาต์พุตเริ่มต้น

หากตั้งค่าทั้ง --data-dir และ --icons-dir คุณไม่จำเป็นต้องใช้ --result-root และจะไม่มีข้อมูลใดๆ เขียนไปยังไดเร็กทอรีนั้น

--data-dir DIR

แทนที่ไดเร็กทอรีที่จะเขียนแคตตาล็อกข้อมูลเมตาของ AppStream ที่สร้างขึ้น ข้อมูลจะถูกเขียนโดยตรงไปยังไดเร็กทอรีนี้ และไม่มีการสร้างไดเร็กทอรีเสริม (ไม่เหมือนกับเมื่อใช้ --result-root เพื่อตั้งค่าตำแหน่งเอาต์พุต)

--icons-dir DIR

แทนที่ไดเร็กทอรีที่ส่งออกไอคอนแคชไป

--hints-dir DIR

ตั้งค่าไดเร็กทอรีที่จะบันทึกคำใบ้ที่รายงานระหว่างการประมวลผลข้อมูลเมตา หากไม่ได้ตั้งค่าพารามิเตอร์นี้ จะไม่มีการบันทึกรายงานคำใบ้ HTML/YAML

--media-dir DIR

หากตั้งค่าไว้ ให้สร้างไดเร็กทอรีที่มีเนื้อหาสื่อ (ไอคอน ภาพหน้าจอ ...) ที่สามารถให้บริการผ่านเว็บเซิร์ฟเวอร์ ข้อมูลเมตาจะถูกขยายเพื่อรวมข้อมูลเกี่ยวกับสื่อระยะไกลเหล่านี้

--media-baseurl URL

URL ที่จะให้บริการเนื้อหาของไดเร็กทอรีที่ตั้งค่าผ่าน --media-dir ต้องตั้งค่านี้หากสร้างไดเร็กทอรีสื่อ

--prefix DIR

ตั้งค่าคำนำหน้าเริ่มต้นที่ใช้ในไดเร็กทอรีที่ประมวลผล หากไม่มีการตั้งค่าอย่างชัดเจน จะถือว่า /usr

--print-report MODE

พิมพ์รายงานคำแนะนำเกี่ยวกับปัญหา (ซึ่งส่งออกเป็นเอกสาร HTML และ YAML เมื่อตั้งค่า --hints-dir) ไปยังคอนโซลในรูปแบบข้อความ

รองรับโหมดการพิมพ์ที่หลากหลาย: เมื่อเกิดข้อผิดพลาด จะพิมพ์เฉพาะรายงานสั้นๆ หากการเรียกใช้ล้มเหลว (ค่าเริ่มต้น) แบบสั้น จะสร้างรายงานแบบย่อที่จะพิมพ์เสมอและแบบเต็ม ส่งผลให้เกิดรายงานโดยละเอียดที่จะพิมพ์

--components COMPONENT-IDs

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

--no-color

อย่าพิมพ์ผลลัพธ์ที่เป็นสี

--verbose

แสดงข้อมูลการดีบักเพิ่มเติม

--version

แสดงหมายเลขเวอร์ชันของการเขียน appstreamcli

ดูสิ่งนี้ด้วย

appstreamcli(1), appstream-generator(1).

ผู้เขียน

หน้าคู่มือนี้เขียนโดย Matthias Klumpp matthias@tenstral.net

ลิขสิทธิ์

ลิขสิทธิ์ © 2020-2022 Matthias Klumpp

หมายเหตุ

1. Freedesktop.org: https://www.freedesktop.org/wiki/Distributions/AppStream/