ตั้งค่าแอป POS Hybrid ใน Android และ iOS
บทความนี้จะแสดงวิธีการสร้างและรันแอปไฮบริดการขายหน้า (POS) ของการขายปลีกบนอุปกรณ์ Android และ iOS
หมายเหตุ
แอปไฮบริด Retail จะถูกแทนที่ด้วยแอป Store Commerce สำหรับ Android และ iOS สำหรับข้อมูลเพิ่มเติม ดูที่ แอป Store Commerce สำหรับแพลตฟอร์มเคลื่อน
แอปไฮบริด Retail คือเชลล์ที่สร้างโดยใช้ Xamarin ภายในเชลล์คือตัวควบคุมมุมมองเว็บที่โหลด Cloud POS (CPOS) ซึ่งเป็นไปตาม URL ของ Commerce Scale Unit ที่ระบุไว้ในการตั้งค่าของแอปนี้ เชลล์ของแอปไฮบริด Retail มีไว้สำหรับ Android และ iOS ซึ่งจะโหลด CPOS แบบภายใน สำหรับข้อมูลเพิ่มเติม ให้ดูที่ Cloud POS
แอป Store Commerce สำหรับ Microsoft Windows และ แพลตฟอร์มอุปกรณ์เคลื่อนที่ เป็นแอปพลิเคชัน POS รุ่นต่อไปสําหรับ Dynamics 365 Commerce Modern POS (MPOS) และแอปไฮบริด Retail จะไม่ได้รับการสนับสนุนในเดือนตุลาคม 2023 Microsoft แนะนําให้คุณใช้ Store Commerce หรือ CPOS สําหรับการปรับใช้ใหม่ทั้งหมด ลูกค้าปัจจุบันควรวางแผนที่จะย้ายข้อมูลจาก MPOS และแอปไฮบริด Retail ไปยัง Store Commerce
เครื่องมือการพัฒนา
แอปไฮบริด Retail สนับสนุนแพลตฟอร์มโทรศัพท์ Android และ iOS แอปนี้สร้างขึ้นโดยใช้ Xamarin ซึ่งหมายความว่าคุณต้องติดตั้ง Xamarin บนคอมพิวเตอร์สำหรับการพัฒนาของคุณ ในการสร้างแอป iOS คุณต้องติดตั้ง Mac ที่มี Xamarin ติดตั้งไว้ ถึงแม้ว่าคุณจะสามารถพัฒนาทั้งบนคอมพิวเตอร์ Android และ iOS ที่รัน Microsoft Windows แต่คุณต้องใช้ Mac ในทำให้การสร้างแพลตฟอร์ม iOS เสร็จสิ้น ถ้า Mac เป็นทรัพยากรของทีมที่ใช้ร่วมกัน คุณอาจต้องการใช้ Mac เฉพาะกับกระบวนการสร้าง คุณต้องคัดลอกชุดการพัฒนาซอฟต์แวร์ Retail (Retail SDK) บนคอมพิวเตอร์ทั้งหมดที่คุณใช้เพื่อการพัฒนา Retail SDK มีอยู่ใน VM ของนักพัฒนาทั้งหมดที่ถูกเตรียมใช้งานในการใช้ Microsoft Dynamics Lifecycle Services (LCS)
สำหรับข้อมูลเพิ่มเติมเกี่ยวกับ Xamarin ดูที่ คู่มือ Xamarin
ตั้งค่าและติดตั้ง Xamarin บน Windows
เมื่อต้องการตั้งค่าและติดตั้ง Xamarin บน Windows ให้ไปที่ การติดตั้ง Windows
อัปเดต Xamarin
หมายเหตุ
ขอแนะนำว่าคุณควรใช้ Xamarin.Android SDK รุ่น < 10.0
หลังจากที่คุณได้ติดตั้ง Xamarin แล้ว คุณต้องอัปเดตเป็นรุ่นล่าสุดที่เสถียร (Xamarin.Android SDK ต้องเป็นรุ่น < 10.0)
- Windows: ใน Microsoft Visual Studio เลือก เครื่องมือ > ตัวเลือก > สภาพแวดล้อม > Xamarin > อื่นๆ
- Mac: ใน Xamarin Studio เลือก ตรวจหาการอัปเดต > ช่องทางอัปเดต สำหรับข้อมูลเพิ่มเติมเกี่ยวกับขั้นตอนนี้ ดูที่ เปลี่ยนช่องทางอัปเดต
สร้างแอปไฮบริด Retail สำหรับ Android
หมายเหตุ
เราขอแนะนำให้ใช้ Visual Studio 2019 หรือใหม่กว่าในการสร้างแอป Android
เพื่อเริ่มการตั้งค่าคอนฟิกแอปไฮบริด Retail สำหรับ Android ให้ปฏิบัติตามขั้นตอนเหล่านี้
เมื่อการติดตั้งเสร็จสมบูรณ์แล้ว ให้เปิด Visual Studio และล็อกอินโดยใช้บัญชี Microsoft ของคุณ (บัญชีเดียวกันกับที่คุณใช้กับ Windows) ตรวจสอบการอัปเดต Xamarin โดยเลือก เครื่องมือ > ตัวเลือก > Xamarin หรือ เครื่องมือ > ตัวเลือก > Xamarin > อื่นๆ คุณจะพบลิงก์ ตรวจสอบทันที ถ้าคุณไม่เห็นตัวเลือกของ Xamarin ที่ เครื่องมือ > ตัวเลือก ตรวจทานการติดตั้งของคุณ หรือลองปิดและเปิด Visual Studio ใหม่ คุณยังสามารถค้นหา Xamarin ในกล่องโต้ตอบ ตัวเลือก ดาวน์โหลดและติดตั้งเวอร์ชันล่าสุดได้ตามต้องการ
ใน โฟลเดอร์ Retail SDK เปิด SampleExtensions\HybridApp\Android\Sample.HybridApp.Android.sln สร้างและใช้งานโดยใช้ตัวเลียนแบบและตรวจสอบว่าทุกอย่างปรากฏตามความควรเป็นอยู่หรือไม่
หมายเหตุ
หากคุณต้องการเพิ่ม URL ของโฮสต์ Azure Active Directory (Azure AD) สำหรับการเปิดใช้งาน ในโซลูชัน ให้แก้ไขไฟล์ PosActivity.cs ค้นหาตัวแปรสตริงอาร์เรย์ที่ชื่อ AadHostUrls และเพิ่ม URL ของโฮสต์ Azure AD ที่กำหนดเองของคุณลงในอาร์เรย์
ในการใช้ Visual Studio Emulator สำหรับ Android หรือตัวเลียนแบบสำหรับ Android ให้เปิดแอป POS Hybrid และป้อน Commerce Scale Unit URL และบันทึก
คุณควรสามารถลงชื่อเข้าใช้และเปิดใช้งานอุปกรณ์ได้
สร้างแอปไฮบริด Retail สำหรับ iOS
เชื่อมต่อกับ Mac
ถ้าคุณพัฒนาบน Windows และใช้ Mac เพียงเพื่อสร้างแอปพลิเคชัน iOS คุณต้องเชื่อมต่อคอมพิวเตอร์ที่รัน Windows กับ Mac สำหรับคำแนะนำ ดูที่ การเชื่อมต่อกับ Mac
ตั้งค่าและติดตั้ง Xamarin บน iOS
หากต้องการตั้งค่าและติดตั้ง Xamarin บน iOS ให้ทำตามขั้นตอนเหล่านี้
- ดาวน์โหลดและติดตั้ง Xcode จาก https://developer.apple.com/xcode/ เพิ่ม Apple ID ของคุณตามคำแนะนำต่อไปนี้ใน การเพิ่มบัญชีของคุณใน Xcode (apple.com)
- ดาวน์โหลดและติดตั้ง Xamarin ตามคําแนะนำต่อไปนี้ใน การติดตั้งและการตั้งค่าคอนฟิก Xamarin.iOS (xamarin.com)
- เมื่อคุณติดตั้ง Xamarin ทั้งบนคอนพิวเตอร์ Windows และ Mac เสร็จแล้ว ทำตามคำแนะนำใน การเชื่อมต่อกับ Mac (xamarin.com) หลังจากที่คุณเชื่อมต่อกับ Mac แล้ว คุณสามารถทำงานกับ iOS และ Mac ได้จาก Visual Studio บนคอมพิวเตอร์ Windows
สำหรับข้อมูลเพิ่มเติมเกี่ยวกับวิธีการติดตั้ง Xamarin บน iOS ดูที่ การติดตั้ง Xamarin.iOS
สร้างแอปไฮบริด Retail สำหรับ iOS
ใน โฟลเดอร์ Retail SDK ให้เปิด SampleExtensions\HybridApp\iOS\solution. หลังจากคุณเชื่อมต่อกับ Mac และสร้างแอปพลิเคชันใน Visual Studio เลือกชนิดอุปกรณ์ iOS และปรับใช้แอปพลิเคชันบนอุปกรณ์ที่เลือก
ใน Emulator ให้ไปที่ การตั้งค่า > Retail Modern Pos และป้อน Commerce Scale Unit URL
เปิดแอป MPOS ตอนนี้คุณควรสามารถลงชื่อเข้าใช้และเปิดใช้งานอุปกรณ์ได้
การลงชื่อและการกระจายแอป Hybrid
เมื่อต้องการลงชื่อและกระจายแอป Android และ iOS ให้ดูที่ตัวเลือกต่อไปนี้
Android
iOS
การสนับสนุนสถานีฮาร์ดแวร์เฉพาะของแอป Android แบบไฮบริด
เริ่มตั้งแต่รุ่น 8.1.3 การสนับสนุนสถานีฮาร์ดแวร์เฉพาะได้เพิ่มเข้าในแอป Android แบบไฮบริดแล้ว ในลักษณะเดียวกันกับที่ Retail Modern POS มีการสนับสนุนในตัวสำหรับอุปกรณ์ต่อพ่วง แอป Android ยังสามารถใช้สถานีฮาร์ดแวร์เฉพาะเพื่อเชื่อมต่อกับอุปกรณ์ต่อพ่วงโดยไม่จำเป็นต้องปรับใช้สถานีฮาร์ดแวร์ที่ใช้ IIS แอป Android แบบไฮบริดที่เป็นแบบสำเร็จรูปรองรับการใช้เครื่องชำระเงินและเครื่องพิมพ์ใบเสร็จผ่านการเชื่อมต่อเครือข่าย โดยทั่วไปแล้ว การสื่อสารกับอุปกรณ์ผ่านเครือข่ายจะต้องปฏิบัติตามโปรโตคอลการสื่อสารที่เป็นกรรมสิทธิ์ซึ่งระบุโดยผู้ผลิต สำหรับแอป Android แบบไฮบริด ซึ่งเป็นการรวมกันแบบสำเร็จรูปมีให้สำหรับ Dynamics 365 Payment Connector สำหรับ Adyen และเครื่องพิมพ์ใบเสร็จ Epson
อุปกรณ์ที่รองรับแบบสำเร็จรูป
| อุปกรณ์ | คำอธิบาย |
|---|---|
| เครื่องชำระเงิน | การสนับสนุนใดๆ โดย Adyen Payment Terminal API จะทำผ่าน Dynamics 365 Payment Connector สำหรับ Adyen |
| เครื่องพิมพ์ใบเสร็จ | เครื่องพิมพ์ Epson ที่เปิดใช้งานเครือข่ายที่สนับสนุนอินเทอร์เฟส Epson SOAP HTTP เครื่องพิมพ์ Star Micronics แบบเครือข่าย |
| ลิ้นชักเงินสด | มีการใช้ใน Dynamics 365 Commerce รุ่น 10.0.8: ลิ้นชักเงินสดที่เชื่อมต่อกับเครื่องพิมพ์ที่เปิดใช้งานเครือข่ายผ่านทางพอร์ตลิ้นชัก (d/k) |
การสนับสนุนตัวประมวลผลการชำระเงินและอุปกรณ์ต่อพ่วงอื่นๆ สามารถใช้งานโดย ISV โดยผ่าน Payments และ Hardware SDK
ตั้งค่าอุปกรณ์ต่อพ่วงเพื่อใช้งานกับแอป Android แบบไฮบริด
หากต้องการเปิดใช้งานการสนับสนุนฮาร์ดแวร์โดยตรงสำหรับแอป Android แบบไฮบริด ให้ตั้งค่าสถานีฮาร์ดแวร์เฉพาะในลักษณะเดียวกับที่ตั้งค่าไว้ให้กับ MPOS คําแนะนําเกี่ยวกับการตั้งค่าสถานีฮาร์ดแวร์เฉพาะหรือ IPC สามารถดูได้ใน อุปกรณ์ต่อพ่วงของ Retail
หมายเหตุ
สถานีฮาร์ดแวร์เฉพาะที่มีข้อมูลสาธิตไม่ควรใช้กับแอป Android แบบไฮบริด หากต้องการทดสอบแอป Android แบบไฮบริดในสภาพแวดล้อมที่มีข้อมูลสาธิต ให้ลบสถานีฮาร์ดแวร์ที่มีอยู่ออก และสร้างสถานีฮาร์ดแวร์เฉพาะใหม่ ไปที่ การขายปลีกและการค้า > ช่องทาง > ร้านค้า > ร้านค้าทั้งหมด และเลือกร้านค้าที่จะใช้ (มักจะเป็น HOUSTON) ในหน้ารายละเอียดร้านค้า บนแท็บด่วน สถานีฮาร์ดแวร์ ให้ลบสถานีฮาร์ดแวร์เฉพาะที่มีอยู่ออก แล้วเลือก เพิ่ม เพื่อเพิ่มสถานีฮาร์ดแวร์ใหม่ในประเภท เฉพาะ ไม่จำเป็นต้องมีคำอธิบาย ไม่ต้องระบุรายละเอียดอื่นเกี่ยวกับสถานีฮาร์ดแวร์
หากต้องการตั้งค่าตัวเชื่อมต่อการชำระเงิน ให้ทำตามขั้นตอนการตั้งค่ามาตรฐานที่ระบุไว้ใน Dynamics 365 Payment Connector สำหรับ Adyen ข้ามส่วนที่มีป้ายชื่อ "อัปเดตการตั้งค่าคอนฟิก Modern POS หรือสถานีฮาร์ดแวร์ IIS"
สำหรับรายละเอียดเกี่ยวกับการตั้งค่าอุปกรณ์ต่อพ่วงที่เชื่อมต่อผ่านเครือข่าย ดูที่เอกสาร การสนับสนุนอุปกรณ์ต่อพ่วงของเครือข่าย