มินแอพ
นิยามใหม่ของการพัฒนามินิโปรแกรม WeChat
บันทึกการเปลี่ยนแปลง
minapp 2.0.0 เปิดตัวแล้ว เวอร์ชันใหม่ใช้ webpack 4 เป็นหลัก โปรดตรวจสอบการอัพเกรดจาก v1.x เป็น v2.x
แนะนำ
minapp เป็นชุดเครื่องมือที่สร้างขึ้นสำหรับการพัฒนาโปรแกรมขนาดเล็กของ WeChat เพื่อปรับปรุงประสบการณ์การพัฒนา:
- จัดเตรียมเครื่องมือบรรทัดคำสั่ง
@minapp/cli
ซึ่งสามารถใช้เพื่อสร้างโปรเจ็กต์ได้อย่างรวดเร็ว และใช้ webpack เพื่อสร้างโปรเจ็กต์ที่สร้างขึ้น - จัดเตรียมเฟรมเวิร์กการพัฒนา
@minapp/core
เฟรมเวิร์กนี้เข้ากันได้กับโค้ดแอปเพล็ตดั้งเดิมอย่างสมบูรณ์ รองรับการพัฒนาโดยใช้คลาส รองรับการเติมโค้ดอัตโนมัติ และยังทำให้ WeChat API ทั้งหมดสมบูรณ์โดยอัตโนมัติ - จัดเตรียมเฟรมเวิร์ก
@minapp/mobx
ที่รวม mobx เฟรมเวิร์กนี้จะแทรก mobx เข้าไปใน @minapp/core
เป็นหลัก ทำให้คุณสามารถใช้ mobx เพื่อจัดการข้อมูลทั่วโลกได้อย่างง่ายดาย - จัดเตรียมปลั๊กอิน vscode
minapp-vscode
โดยหลักแล้วเป็นภาษาเทมเพลต wxml
สำหรับโปรแกรมขนาดเล็ก ซึ่งสามารถเติมส่วนประกอบทั้งหมด คุณลักษณะของส่วนประกอบ ค่าคุณลักษณะของส่วนประกอบ ฯลฯ ได้โดยอัตโนมัติ
หมายเหตุ: หลังจากใช้ minapp คุณยังคงต้องใช้ "เครื่องมือสำหรับนักพัฒนา WeChat" ที่ได้รับอย่างเป็นทางการจาก WeChat สำหรับการทดสอบ
ใช้
- ใช้ npm เพื่อติดตั้งเครื่องมือบรรทัดคำสั่ง:
npm install -g @minapp/cli
- เริ่มต้นโปรเจ็กต์:
minapp init <你要创建项目的文件夹>
(รองรับการสร้างโปรเจ็กต์ js และ ts ในเวลาเดียวกัน) - ติดตั้งปลั๊กอิน vscode สองตัว: minapp และ dot-template (เป็นทางเลือก แต่แนะนำ)
คุณสมบัติ
- เข้ากันได้กับมินิโปรแกรมเนทีฟอย่างสมบูรณ์ รหัสมินิโปรแกรมเนทีฟทั้งหมดสามารถย้ายไปยังสภาพแวดล้อม minapp ได้โดยตรง
- รวม webpack และ webpack-dev-server เพื่อให้แน่ใจว่ามีการคอมไพล์
- คุณสามารถเลือกใช้ mobx เพื่ออำนวยความสะดวกในการจัดการข้อมูลทั่วโลก
- ทุกภาษาสามารถเติมให้สมบูรณ์ได้โดยอัตโนมัติในสภาพแวดล้อม minapp และประสบการณ์การพัฒนาก็ยอดเยี่ยมมาก (ดู
功能概览
ด้านล่าง) - รองรับการผูกข้อมูลแบบสองทาง
- การเพิ่มประสิทธิภาพการทำงานของ setData
ภาพรวมฟังก์ชั่น (ภายใต้โปรแกรมแก้ไข vscode)
อินเทอร์เฟซ wx ทั้งหมดมีการแจ้งเตือนอัจฉริยะ รวมถึงพารามิเตอร์อินเทอร์เฟซและค่าที่ส่งคืน
ผู้ใช้ที่ไม่ใช่ minapp ยังสามารถติดตั้ง @minapp/wx
เพื่อรับฟีเจอร์นี้ได้ ดูที่นี่
จัดเตรียมเวอร์ชันสัญญาของอินเทอร์เฟซ wx wxp ซึ่งเหมือนกับ wx ยกเว้นว่าจะรับประกันฟังก์ชันทั้งหมดใน wx ที่ต้องใช้พารามิเตอร์สามตัวคือ สำเร็จ/ล้มเหลว/สมบูรณ์
- wxp ยังรองรับการใช้การเรียกกลับสำเร็จ
- wxp เพิ่มวิธีการสุดท้ายให้กับ Promise; ตัวอย่างเช่น คุณสามารถใช้
wxp.getUserInfo().finally(() => { /* do something */ })
การรวม mobx ทำให้สะดวกมากในการแก้ไขข้อมูลทั่วโลกและอัปเดตสถานะหน้าปัจจุบันโดยอัตโนมัติ
- หากต้องการแทรก Store คุณจะต้องเพิ่มวัตถุ Store ในฟังก์ชัน appify เท่านั้น
- ออบเจ็กต์ Store จะถูกแทรกลงในเพจและคอมโพเนนต์ตามค่าเริ่มต้น คุณสามารถใช้
this.store
เพื่อรับออบเจ็กต์เหล่านั้น
ภาษาเทมเพลต wxml รองรับการเน้นไวยากรณ์, คอมโพเนนต์สมาร์ทพรอมต์ และคอมโพเนนต์สมาร์ทพรอมต์แอตทริบิวต์ (ต้องติดตั้ง minapp ปลั๊กอิน vscode)
สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับฟังก์ชันของปลั๊กอินนี้ คลิกที่นี่เพื่อดู
ไฟล์ json รองรับการแจ้งอัตโนมัติ
เมื่อสร้างโฟลเดอร์หน้าใหม่ ไฟล์ที่เกี่ยวข้องจะถูกสร้างขึ้นโดยอัตโนมัติ (จำเป็นต้องติดตั้งปลั๊กอิน vscode dot-template)
- สร้างไฟล์ที่เกี่ยวข้องโดยอัตโนมัติด้วยชื่อเดียวกันสำหรับคุณ รวมถึง js/json/wxml/scss และคุณสามารถแก้ไขไฟล์เทมเพลตเหล่านี้ได้ตลอดเวลาในโฟลเดอร์ .dtpl
- แทรกเส้นทางเพจที่สร้างขึ้นใหม่ลงในโฟลเดอร์ app.json โดยอัตโนมัติ
มินิโปรแกรมเพจรองรับการแจ้งฟังก์ชันอัตโนมัติ
ในทำนองเดียวกัน เมื่อสร้างโฟลเดอร์ส่วนประกอบใหม่ ไฟล์ที่เกี่ยวข้องจะถูกสร้างขึ้นด้วย ในเวลาเดียวกัน ฟังก์ชันวงจรชีวิตในส่วนประกอบจะแจ้งเตือนโดยอัตโนมัติด้วย
เกี่ยวกับคำอธิบายคลังสินค้านี้
นี่ไม่ใช่โปรเจ็กต์เดียว แต่เป็นการรวมกันของหลายโปรเจ็กต์โดยใช้เครื่องมือพัฒนา lerna โปรเจ็กต์อื่นๆ อยู่ในไดเร็กทอรีแพ็กเกจ ต่อไปนี้เป็นภาพรวมโดยย่อของหลายโปรเจ็กต์หลัก
- minapp-generator: โมดูลนี้มีหน้าที่รับผิดชอบในการแยกวิเคราะห์เอกสารอย่างเป็นทางการของ WeChat และสร้างข้อมูลที่มีโครงสร้างเพื่อใช้โดยโมดูลอื่น
- minapp-wx: คำจำกัดความ TypeScript ของ API ดั้งเดิมทั้งหมดของ WeChat และยังมีเวอร์ชันสัญญาของอินเทอร์เฟซ wx
- minapp-core: กรอบการพัฒนาจำเป็นต้องขึ้นอยู่กับ minapp-wx
- minapp-mobx: กรอบการพัฒนาที่รวม mobx และจำเป็นต้องพึ่งพา minapp-core
- minapp-cli: เครื่องมือบรรทัดคำสั่งที่มอบให้กับผู้ใช้และสามารถสร้างโปรเจ็กต์ใหม่ได้อย่างรวดเร็ว
- minapp-vscode: ปลั๊กอิน vscode ที่ให้การเน้นไวยากรณ์ การเติมแท็กและแอตทริบิวต์ให้สมบูรณ์โดยอัตโนมัติสำหรับ wxml
สิ่งที่ต้องทำ