ดาวน์โหลด libplist - ดาวน์โหลดซอร์สโค้ด libplist

libplist

ซี/ซี++

2.6.0

ดาวน์โหลด

libplist

ไลบรารี C แบบพกพาขนาดเล็กเพื่อจัดการไฟล์รายการคุณสมบัติของ Apple ในรูปแบบ Binary, XML, JSON หรือ OpenStep

สารบัญ

คุณสมบัติ
อาคาร
- ข้อกำหนดเบื้องต้น
  - Linux (Debian/Ubuntu)
  - แม็กอส
  - หน้าต่าง
- การกำหนดค่าแผนผังต้นทาง
- อาคารและการติดตั้ง
การใช้งาน
การบริจาค
ลิงค์
ใบอนุญาต
การให้เครดิต

คุณสมบัติ

โครงการจัดทำอินเทอร์เฟซเพื่ออ่านและเขียนไฟล์ PLIST ในรูปแบบ Binary, XML, JSON หรือ OpenStep พร้อมกับยูทิลิตี้บรรทัดคำสั่งชื่อ plistutil

คุณสมบัติที่สำคัญบางอย่างคือ:

รูปแบบ: รองรับรูปแบบไบนารี XML, JSON และ OpenStep
ยูทิลิตี้: จัดเตรียมยูทิลิตี้ plistutil สำหรับบรรทัดคำสั่ง
Python: จัดเตรียมการผูกที่ใช้ Cython สำหรับ Python
ทดสอบ: ใช้การฟัซซิ่ง (OSS-FUZZ) และการทดสอบการปฏิบัติตามข้อมูล
มีประสิทธิภาพ: ห้องสมุดลีนที่มีประสิทธิภาพและทรัพยากรอยู่ในใจ

อาคาร

ข้อกำหนดเบื้องต้น

คุณต้องมีคอมไพเลอร์ที่ใช้งานได้ (GCC/Clang) และสภาพแวดล้อมการพัฒนาที่มีอยู่ โครงการนี้ใช้ autotools สำหรับกระบวนการสร้างช่วยให้มีขั้นตอนการสร้างทั่วไปในแพลตฟอร์มที่แตกต่างกัน มีเพียงข้อกำหนดเบื้องต้นที่แตกต่างกันและอธิบายไว้ในส่วนนี้

Linux (Debian/Ubuntu)

ติดตั้งการพึ่งพาและเครื่องมือสร้างที่จำเป็นทั้งหมด:
```
sudo apt-get install 
  build-essential 
  checkinstall 
  git 
  autoconf 
  automake 
  libtool-bin
```
หากคุณต้องการเลือกการใช้เอกสารหรือการเชื่อมโยง Python โดยเลือก:
```
sudo apt-get install 
	doxygen 
	cython3
```

แม็กอส

ตรวจสอบให้แน่ใจว่ามีการติดตั้งเครื่องมือบรรทัดคำสั่ง xcode จากนั้นใช้ MacPorts หรือ Homebrew เพื่อติดตั้ง automake , autoconf และ libtool
ใช้ MacPorts:
```
sudo port install libtool autoconf automake
```
ใช้ homebrew:
```
brew install libtool autoconf automake
```
ในกรณีที่คุณต้องการสร้างเอกสารให้ติดตั้ง doxygen โดยใช้คำสั่งการติดตั้งที่เกี่ยวข้องจากด้านบน
หากคุณต้องการสร้างการผูก Python คุณต้องติดตั้ง Cython:
```
pip3 install cython
```
คุณอาจต้องตั้งค่าตัวแปรสภาพแวดล้อมสองสามตัวหากการสร้างการผูกพง ๆ ล้มเหลว ตัวอย่างเช่นการสร้างอัตโนมัติผ่านการกระทำของ GitHub กำลังตั้งค่าตัวแปรสภาพแวดล้อมต่อไปนี้:
```
PYTHON3_BIN= ` xcrun -f python3 `
export PYTHON= $PYTHON3_BIN
PYTHON_VER= ` $PYTHON3_BIN -c " import distutils.sysconfig; print(distutils.sysconfig.get_config_var('VERSION')) " `
PYTHON_EXEC_PREFIX= ` $PYTHON3_BIN -c " import distutils.sysconfig; print(distutils.sysconfig.get_config_var('exec_prefix')) " `
PYTHON_LIBS_PATH= $PYTHON_EXEC_PREFIX /lib
PYTHON_FRAMEWORK_PATH= $PYTHON_EXEC_PREFIX /Python3
export PYTHON_LIBS= " -L $PYTHON_LIBS_PATH -lpython $PYTHON_VER "
export PYTHON_EXTRA_LDFLAGS= " -Wl,-stack_size,1000000  -framework CoreFoundation $PYTHON_FRAMEWORK_PATH " 
```

หน้าต่าง

การใช้ MSYS2 เป็นวิธีการอย่างเป็นทางการในการรวบรวมโครงการนี้บน Windows ดาวน์โหลดตัวติดตั้ง MSYS2 และทำตามขั้นตอนการติดตั้ง
ขอแนะนำให้ใช้เชลล์ 64 บิต MSYS2 MINGW เรียกใช้และตรวจสอบให้แน่ใจว่ามีการติดตั้งการพึ่งพาที่ต้องการ:
```
pacman -S base-devel 
	git 
	mingw-w64-x86_64-gcc 
	make 
	libtool 
	autoconf 
	automake-wrapper
```
หมายเหตุ: คุณสามารถใช้เชลล์ที่แตกต่างกันและคอมไพเลอร์ที่แตกต่างกันตามความต้องการของคุณ ปรับคำสั่งข้างต้นตาม
หากคุณต้องการเลือกสร้างการผูก Python คุณต้องติดตั้ง cython และตรวจสอบให้แน่ใจว่าคุณมีสภาพแวดล้อม Python ที่ใช้งานได้
```
pacman -S cython
```

การกำหนดค่าแผนผังต้นทาง

คุณสามารถสร้างซอร์สโค้ดจากการชำระเงิน GIT หรือจาก .tar.bz2 รีลีส Tarball จากรุ่น ก่อนที่เราจะสามารถสร้างได้แผนผังต้นทางจะต้องมีการกำหนดค่าสำหรับการสร้าง ขั้นตอนขึ้นอยู่กับที่คุณได้รับแหล่งที่มา

จาก Git
หากคุณยังไม่ได้ดำเนินการโคลนที่เก็บข้อมูลจริงและเปลี่ยนเป็นไดเรกทอรี
```
git clone https://github.com/libimobiledevice/libplist.git
cd libplist
```
กำหนดค่าแผนผังต้นทางสำหรับการสร้าง:
```
./autogen.sh
```
จากการปล่อย Tarball (.tar.bz2)
เมื่อใช้ Tarball อย่างเป็นทางการ ( libplist-xyztar.bz2 ) ขั้นตอนจะแตกต่างกันเล็กน้อย
สกัด tarball:
```
tar xjf libplist-x.y.z.tar.bz2
cd libplist-x.y.z
```
กำหนดค่าแผนผังต้นทางสำหรับการสร้าง:
```
./configure
```

ทั้ง ./configure และ ./autogen.sh (ซึ่งสร้างและ configure การโทร) ยอมรับตัวเลือกสองสามตัวตัวอย่างเช่น --enable-debug เพื่ออนุญาตให้พิมพ์ข้อความการดีบักในผลิตภัณฑ์ขั้นสุดท้ายหรือ --without-cython การข้ามการสร้างการเชื่อมโยง Python คุณสามารถผ่านพวกเขาเช่นนี้ได้:

./autogen.sh --prefix=/usr/local --enable-debug --without-cython

หรือ

./configure --prefix=/usr/local --enable-debug

เมื่อคำสั่งประสบความสำเร็จเอาต์พุตสองสามบรรทัดสุดท้ายจะมีลักษณะเช่นนี้:

 [...]
config.status: creating config.h
config.status: executing depfiles commands
config.status: executing libtool commands

Configuration for libplist 2.3.1:
-------------------------------------------

  Install prefix ..........: /usr/local
  Debug code ..............: yes
  Python bindings .........: yes

  Now type 'make' to build libplist 2.3.1,
  and then 'make install' for installation.

อาคารและการติดตั้ง

หากคุณทำตามขั้นตอนทั้งหมดได้สำเร็จและ autogen.sh หรือ configure ไม่ได้พิมพ์ข้อผิดพลาดใด ๆ คุณพร้อมที่จะสร้างโครงการ สิ่งนี้ทำได้ง่ายๆ

make

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

make install

หรือ

sudo make install

หากคุณอยู่ใน Linux คุณต้องการเรียกใช้ sudo ldconfig หลังจากการติดตั้งเพื่อให้แน่ใจว่ามีการติดตั้งไลบรารี

การใช้งาน

การใช้งานง่าย libplist มี API ตรงไปข้างหน้า มันถูกใช้ใน libimobiledevice และโครงการที่เกี่ยวข้อง

นอกจากนี้ยังมาพร้อมกับสาย plistutil ของสายคำสั่งที่ใช้งานง่ายจริงๆ:

plistutil -i foobar.plist -o output.plist

สิ่งนี้จะแปลงไฟล์ foobar.plist เป็นรูปแบบตรงข้ามเช่นไบนารีเป็น XML หรือในทางกลับกันและส่งออกไปยังไฟล์ output.plist

ในการแปลงเป็นรูปแบบเฉพาะ - และเพื่อแปลงจากรูปแบบ JSON หรือ OpenStep - ใช้สวิตช์บรรทัดคำสั่ง -f :

plistutil -i input.plist -f json

สิ่งนี้จะแปลง input.plist โดยไม่คำนึงถึงรูปแบบอินพุตเป็น JSON โค้ดตรวจจับรูปแบบอินพุตอัตโนมัติและแยกวิเคราะห์ตามนั้น

โปรดปรึกษาข้อมูลการใช้งานหรือหน้าคู่มือสำหรับเอกสารฉบับเต็มของตัวเลือกบรรทัดคำสั่งที่มีอยู่:

plistutil --help

หรือ

man plistutil

การบริจาค

เรายินดีต้อนรับการมีส่วนร่วมจากทุกคนและขอบคุณสำหรับทุกคำขอดึง!

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

หากคุณวางแผนที่จะมีส่วนร่วมในการเปลี่ยนแปลงที่ใหญ่ขึ้นหรือการปรับโครงสร้างที่สำคัญโปรดสร้างตั๋วก่อนเพื่อหารือเกี่ยวกับแนวคิดล่วงหน้าเพื่อให้แน่ใจว่าทุกคนใช้ความพยายามน้อยลง

โปรดตรวจสอบให้แน่ใจว่าการบริจาคของคุณเป็นไปตาม:

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

ลิงค์

หน้าแรก: https://libimobiledevice.org/
ที่เก็บ: https://github.com/libimobiledevice/libplist.git
ที่เก็บ (กระจก): https://git.libimobiledevice.org/libplist.git
ตัวติดตามปัญหา: https://github.com/libimobiledevice/libplist/issues
รายชื่อผู้รับจดหมาย: https://lists.libimobiledevice.org/mailman/listinfo/libimobiledevice-dev
Twitter: https://twitter.com/libimobiledev