phongent qo‘llanmasi: iPhone yoki Android orqali bir nechta telefon Agent’larini birgalikda boshqarish

phongent nima

phongent — bir nechta qurilmadagi Agent’larni birgalikda boshqarish loyihasi. U tabiiy tildan foydalanib barcha qurilmalarga, muayyan qurilmalar guruhiga yoki tanlangan qurilmaga vazifalar berish, ijro jarayoni, natijalar, bildirishnomalar va Android qurilmalarining real vaqt ekranini bitta interfeysda ko‘rish imkonini beradi.

iOS va Android boshqaruv qurilmasi sifatida ishlashi, Android ijro qurilmalariga ulanishi va ularni boshqarishi mumkin. Har ikkisi ham vazifa berish, natijalarni ko‘rish, xabarlarni boshqarish, real vaqt oynasi va boshqaruvni qo‘lga olishni qo‘llab-quvvatlaydi; faqat Android qurilmasi o‘zidagi App amallarini bevosita bajara oladi.

Eslatma: iOS hozircha faqat boshqaruv qurilmasi sifatida Android ijro qurilmalariga ulanadi; iPhone’dagi App amallarini bajara olmaydi.

Asosiy funksiyalar

• Bir nechta qurilmaga vazifa berish: qurilmani uzoq bosib, vazifani tavsiflang yoki boshqaruv qurilmasidagi vazifa agentiga qurilmalarga vazifalarni qanday yuborishni mustaqil hal qilishga imkon bering.
• Qurilmalar guruhida hamkorlik: vazifalarni butun guruhga ommaviy tarzda bajartiring yoki turli guruhlarga yoxud guruh ichidagi alohida qurilmalarga turli vazifalar bering.
• Kontent yaratish va tarqatish: boshqaruv modeli bir nechta matn va matnli grafik kartalarni yaratib, turli kontentni mos qurilmalarga topshirishi hamda rasmlarni biriktirishni qo‘llab-quvvatlashi mumkin.
• Android real vaqt oynasi: Android virtual ekrani tasvirini ko‘ring va bosish, surish hamda kiritish orqali qurilmani boshqaring. Bu funksiya sukut bo‘yicha yoqilgan, uni sozlamalarda o‘chirish mumkin.
• Xabarlarni markazlashgan holda boshqarish: bildirishnomalarni qurilma, ilova va xabar manbasi bo‘yicha tartiblang hamda maqsadli Android qurilmasidagi Agent’ga xabarlarga javob berishni topshiring.
• Markazlashgan sozlash: xotira, ko‘nikmalar, rejalashtirilgan vazifalar va amallar ketma-ketligini boshqaring; bitta qurilmani yoki bir nechta qurilmani tanlang.
• Ulanishni boshqarish: mahalliy tarmoq orqali aniqlash, dastlabki avtorizatsiya, bir marta bosib ulanish, uzilgandan keyin qayta ulanish, qurilma nomini o‘zgartirish va qurilmalar panjarasini qo‘llab-quvvatlaydi.

O‘rnatishdan oldingi tayyorgarlik

Qurilma va tizim talablari

• Ijro qurilmasi sifatida kamida bitta Android qurilmasini tayyorlang.
• Boshqaruv qurilmasi iPhone yoki Android qurilmasi bo‘lishi mumkin.
• Boshqaruv va ijro qurilmalari bir xil mahalliy tarmoqqa ulangan bo‘lishi kerak.
• Android uchun eng past o‘rnatish versiyasi Android 11. Muayyan amallarni bajarish imkoniyati tizim versiyasi va ruxsatlar sozlamalariga ham bog‘liq.
• iOS uchun eng past deployment versiyasi iOS 17. Hozircha Xcode orqali qurish, imzolash va o‘rnatish kerak.

To‘g‘ri o‘rnatish paketini tanlash

Android foydalanuvchilari loyiha relizlar sahifasidan phongent.apk faylini yuklab olishlari mumkin. phongent loyihasi taqdim etgan build’dan foydalaning, yuqori darajadagi loyihaning APK faylidan foydalanmang, chunki unda bir nechta qurilmani guruh bo‘lib boshqarish uchun zarur interfeyslar bo‘lmasligi mumkin.

Tezkor sozlash va ulanish

1. Ilovani o‘rnating. Android qurilmasiga phongent APK faylini o‘rnating. iOS boshqaruv qurilmasi uchun macOS’da Xcode orqali build yaratish, imzolash va o‘rnatish kerak.
2. Android ijro qurilmasini sozlang. Ilovada kerakli model va telefonni boshqarish imkoniyatlarini sozlang hamda amaldagi funksiyalarga ko‘ra accessibility, bildirishnomalarni o‘qish kabi ruxsatlarni bering. Telefonni boshqarishning quyi darajadagi sozlamalari uchun loyihaning sozlash qo‘llanmasiga qarang.
3. Ijro qurilmasi xizmatini ish holatida saqlang. Android tomonidagi xizmat ishga tushganini tekshiring va boshqaruv qurilmasi Android ijro qurilmasi bilan bir xil mahalliy tarmoqqa ulanganiga ishonch hosil qiling.
4. Qurilmaga ulaning. Boshqaruv qurilmasidagi “Qurilmalar” sahifasidan aniqlangan Android qurilmasini tanlang yoki “Bir marta bosib ulanish”dan foydalaning. Birinchi ulanishda Android tomonida avtorizatsiyani tasdiqlash kerak.
5. Boshqaruv modelini sozlang. Boshqaruv sozlamalariga kirib, vazifalarni tushunish va yuborish uchun javob beradigan modelni sozlang. Tegishli ilova hisoblari mos ijro qurilmalarida tizimga kirgan bo‘lishi kerak.
6. Hamkorlikni boshlang. “agent” sahifasiga kirib, barcha qurilmalarni, bitta qurilmalar guruhini yoki alohida qurilmani tanlang, so‘ng tabiiy tilda vazifani kiriting.

Qurilma dastlabki avtorizatsiyadan o‘tgach, uzilgandan keyin qayta ulanishi mumkin. Qurilma aniqlanmasa, ilovani darhol qayta o‘rnatish o‘rniga avval mahalliy tarmoq ulanishi va Android tomonidagi xizmat holatini tekshiring.

To‘rtta asosiy bo‘lim

• Qurilmalar: Android qurilmalarini aniqlash, ulash, qayta nomlash va guruhlash.
• agent: vazifalar berish, ijro jarayoni, natijalar va real vaqt oynasini ko‘rish.
• Xabarlar: bildirishnomalarni qurilma, ilova va manba bo‘yicha ko‘rish hamda javob berish vazifalarini boshlash.
• Sozlamalar: boshqaruv modeli, ijro qurilmasi imkoniyatlari va tegishli sinxronlash parametrlarini sozlash.

Asosiy foydalanish: qurilmaga vazifa yuborish

Turli qurilmalarga turli vazifalar berish

Faraz qilaylik, qurilmalar nomi A va B. Vazifada har bir qurilma nima qilishi kerakligini bevosita ko‘rsatishingiz mumkin:

A Xiaohongshu bosh sahifasini ochib, skrinshot olsin, B brauzerni ochib, bugungi ob-havoni ko‘rsin.

Yuborgandan so‘ng, ijro jarayoni va natijalarni qurilma bo‘yicha ko‘rishingiz mumkin. Android tomonidagi amallarni kuzatish yoki tuzatish kerak bo‘lsa, tegishli qurilmaning real vaqt oynasini ochib, bosish, surish yoki kiritish orqali boshqaruvni qo‘lga oling.

Qurilmalar guruhi bilan ommaviy hamkorlik

Kontent yaratish, tekshirish yoki operatsiyalar kabi takroriy ishlar uchun avval qurilmalar guruhini yarating, so‘ng guruh nomi orqali vazifalar bering:

Kontent guruhi alohida-alohida mahsulot taqdimoti loyihasini yaratsin, tekshiruv guruhi har bir qurilmaning vazifa holatini ko‘rsin.
Kontent guruhidagi A mavjud materiallarni tartiblasin, qolgan qurilmalar loyiha yaratishda davom etsin.

Bunday tavsif butun guruhga umumiy maqsad berishi yoki guruh ichidagi muayyan qurilmaning vazifasini o‘zgartirishi mumkin.

Turli kontentni yaratish va tarqatish

Har bir qurilma turli materialni qayta ishlashi kerak bo‘lsa, boshqaruv modelidan kontentni alohida-alohida yaratishni, keyin esa har bir qurilmaga yuborishni so‘rashingiz mumkin:

Kontent guruhidagi har bir qurilma uchun turli sarlavha, asosiy matn va matnli grafik karta yarating,
ularni mos qurilmalarga alohida yuboring, qoralama sifatida saqlang, hozircha nashr etmang.

Vazifaga “qoralama sifatida saqlang, hozircha nashr etmang” kabi cheklovlarni aniq kiritish kutilayotgan amal chegaralarini ifodalashga yordam beradi. Amaldagi ijro esa model sozlamalari, maqsadli App holati, hisobga kirilganligi va berilgan tizim ruxsatlariga bog‘liq.

Qurilmalar guruhini yaratish va boshqarish

1. “Qurilmalar” sahifasini oching. Pastdagi panjarada hozir ulangan qurilmalar, har bir qurilmaning nomi va tegishli guruhi ko‘rsatiladi.
2. “Guruhlash”ni bosing va boshqarish kerak bo‘lgan qurilmalarni belgilang.
3. Mavjud guruhni tanlang yoki yangi guruh yarating.
4. Ommaviy ko‘chirishni yakunlash uchun “N ta qurilmani ko‘chirish”ni bosing.

Har bir qurilma faqat bitta guruhga tegishli bo‘lishi mumkin; ko‘chirilgandan keyin u avvalgi guruhdan chiqadi. Qo‘lda guruhlanmagan qurilmalar “Standart guruh”ga kiritiladi.

Qurilma avatari yoki kartasini uzoq bosib, qurilma nomini o‘zgartirishingiz yoki uni boshqa guruhga ko‘chirishingiz mumkin. Qurilma nomini o‘zgartirish mos Android App’ga sinxronlashga urinadi, ammo buning uchun ijro qurilmasi tegishli interfeysni qo‘llab-quvvatlashi kerak.

Guruh ma’lumotlari joriy boshqaruv qurilmasida saqlanadi va boshqa boshqaruv qurilmasiga avtomatik sinxronlanmaydi. Bir nechta boshqaruv qurilmasi ishlatiladigan muhitda har bir boshqaruv qurilmasining guruhlarini alohida yuritish kerak.

Bildirishnomalarni markazlashgan holda ko‘rish va ularga javob berish

phongent ruxsat berilgan Android bildirishnomalarini o‘qib, ularni qurilma, ilova va xabar manbasi bo‘yicha tartiblay oladi. “Xabarlar” sahifasiga kirgach, bildirishnoma tafsilotlarini ko‘rishingiz va javob berish vazifasini mos Android qurilmasidagi Agent’ga topshirishingiz mumkin.

1. Maqsadli Android qurilmasiga bildirishnomalarni o‘qish ruxsati berilganini tekshiring.
2. Boshqaruv qurilmasida “Xabarlar” bo‘limini oching.
3. Maqsadli bildirishnomani qurilma, ilova yoki manba bo‘yicha toping.
4. Bildirishnoma tafsilotlariga kirib, javob berish vazifasini boshlang.
5. Haqiqiy javob berish amalini maqsadli Android qurilmasidagi Agent bajarsin.

Boshqaruv qurilmasida bildirishnomalar ko‘rinmasa, avval maqsadli Android qurilmasining bildirishnomalarni o‘qish ruxsati, ijro xizmati va ulanish holatini tekshiring.

Ilg‘or foydalanish usullari

Vazifa tavsifini ijro uchun qulay qilish

• Qurilma yoki guruh nomini aniq yozing: masalan, “Kontent guruhi”, “Tekshiruv guruhi” yoki “A qurilmasi”.
• Turli maqsadlarni ajrating: har bir qurilmaning amalini aniq ko‘rsating, bir nechta qurilmaga qo‘yilgan talablarni noaniq bitta jumlaga aralashtirmang.
• Yakuniy holatni ko‘rsating: masalan, “skrinshotdan so‘ng natijani qaytaring”, “qoralama sifatida saqlang”, “hozircha nashr etmang”.
• Guruh ichidagi vazifani o‘zgartiring: avval butun guruhga maqsad bering, keyin alohida qurilma nima qilishi kerakligini ko‘rsating.
• Avval hisoblarni tekshiring: uchinchi tomon App’lari bilan ishlaganda tegishli Android qurilmalarida hisobga oldindan kiring.

Real vaqt oynasidan oqilona foydalanish

Real vaqt oynasi Agent amallarini kuzatish yoki avtomatik amal sahifadagi o‘zgarishlarga duch kelganda qo‘lda boshqaruvni qo‘lga olish uchun qulay. U sukut bo‘yicha yoqilgan; real vaqt tasviri kerak bo‘lmasa, uni sozlamalarda o‘chirishingiz mumkin.

Ijro qurilmalarini ommaviy boshqarish

Xotira, ko‘nikmalar, rejalashtirilgan vazifalar va amallar ketma-ketligi kabi sozlamalarni markazlashgan holda boshqarish hamda funksiya bo‘yicha bitta yoki bir nechta qurilmani tanlash mumkin. Ommaviy o‘zgartirishdan oldin tanlangan qurilmalar doirasini tekshiring, aks holda faqat bitta qurilmaga mos sozlama butun guruhga qo‘llanishi mumkin.

Ulanish muammolarini hal qilish

• Boshqaruv va ijro qurilmalari bir xil mahalliy tarmoqda ekanini tekshiring.
• Android ijro qurilmasi xizmati hali ham ishlayotganini tekshiring.
• Birinchi ulanishda Android qurilmasida avtorizatsiyani yakunlang.
• Avtorizatsiyadan o‘tgan qurilma uzilgach, qayta ulanishga urinib ko‘ring yoki “Bir marta bosib ulanish”dan foydalaning.
• Qurilmalar panjarasida faqat ulangan qurilmalar ko‘rsatiladi; ko‘rinmagan qurilma muvaffaqiyatli ulangan degani emas.

Android versiyasini manba kodidan qurish

Loyihaning Android ilovasi, boshqaruv interfeysi va ijro qurilmasi xizmati app/ ichida, Agent’ning asosiy imkoniyatlari esa core/ ichida joylashgan. Qurish uchun JDK 17 va Android SDK kerak; hozir compileSdk 36 ishlatiladi.

./gradlew :app:assembleDebug

Debug APK fayli app/build/outputs/apk/debug/ ichida hosil bo‘ladi. O‘rnatishdan oldin build natijasi o‘zingizning ishlab chiqish imzongiz bilan imzolanganini tekshiring.

iOS boshqaruv versiyasini manba kodidan qurish

iOS build’i uchun macOS hamda loyiha ishlatadigan SDK’ni qo‘llab-quvvatlaydigan Xcode kerak. Eng past deployment versiyasi iOS 17.

1. Xcode orqali ios/MikaRemote.xcodeproj faylini oching.
2. MikaRemote scheme’ini tanlang.
3. Imzolash sozlamalarida o‘zingizning ishlab chiqish jamoangizni tanlang.
4. Maqsadli iPhone’ni ulang, so‘ng build yarating va o‘rnating.

Repozitoriydagi ios/ katalogida iOS boshqaruv ilovasi, komponentlar va real vaqt faoliyati mavjud; tools/android-emulators/ Android emulyatorlari bilan birgalikda sozlash vositalarini taqdim etadi; sozlash qo‘llanmasi, protokollar va tekshiruv qaydlari docs/ ichida joylashgan.

Xavfsizlik eslatmasi: model kalitlari, hisob ma’lumotlari va qurilmadagi imzolash materiallarini manba kodiga yozmaslik yoki versiyalar omboriga yubormaslik kerak.

Xulosa

phongent bir nechta Android qurilmalarini markazlashgan holda boshqariladigan Agent ijro muhitiga birlashtiradi va iPhone yoki Android qurilmasidan boshqaruv qurilmasi sifatida foydalanish imkonini beradi. Ijro qurilmasi ruxsatlari, mahalliy tarmoq ulanishi va boshqaruv modeli sozlangach, alohida qurilmaga, qurilmalar guruhiga yoki barcha qurilmalarga vazifalar berish, natijalar, real vaqt tasvirlari va bildirishnomalarni ko‘rish mumkin. Loyiha Mika asosida ishlab chiqilgan va Apache License 2.0 litsenziyasidan foydalanadi.