Mafunzo ya phongent: Dhibiti kwa pamoja simu nyingi za Agent ukitumia iPhone au Android

phongent ni nini

phongent ni mradi wa udhibiti na ushirikiano wa Agent kwenye vifaa vingi. Hukuwezesha kutumia lugha ya kawaida kugawa kazi kwa vifaa vyote, kikundi fulani cha vifaa au kifaa maalum, na kutazama maendeleo ya utekelezaji, matokeo, ujumbe wa arifa na skrini ya moja kwa moja ya vifaa vya Android katika kiolesura kimoja.

iOS na Android zinaweza kutumika kama vifaa vya udhibiti, vinavyounganisha na kusimamia vifaa vya Android vya utekelezaji. Vyote vinaunga mkono ugawaji wa kazi, kutazama matokeo, usimamizi wa ujumbe, dirisha dogo la moja kwa moja na udhibiti wa moja kwa moja; Android pekee ndiyo inaweza kutekeleza kazi za kuendesha programu kwenye kifaa hicho.

Angalizo: Kwa sasa iOS hutumika tu kama kifaa cha udhibiti kinachounganisha na vifaa vya Android vya utekelezaji; haiwezi kutekeleza kazi za programu kwenye iPhone yenyewe.

Vipengele muhimu

• Ugawaji wa kazi kwenye vifaa vingi: Bonyeza kwa muda kifaa na ueleze kazi, au ruhusu wakala wa kazi wa kifaa cha udhibiti aamue jinsi ya kutuma kazi kwenye vifaa.
• Ushirikiano wa vikundi vya vifaa: Chagua kikundi kizima ili kutekeleza kazi kwa pamoja, au gawa kazi tofauti kwa vikundi tofauti au kifaa kimoja ndani ya kikundi.
• Uundaji na usambazaji wa maudhui: Muundo wa kifaa cha udhibiti unaweza kuunda nakala kadhaa za maudhui na kadi za picha zenye maandishi, kisha kupeleka maudhui tofauti kwenye vifaa vinavyohusika, pamoja na picha.
• Dirisha dogo la moja kwa moja la Android: Tazama skrini pepe ya Android na udhibiti kifaa kwa kubofya, kutelezesha na kuandika. Kipengele hiki huwashwa kwa chaguo-msingi na kinaweza kuzimwa kwenye mipangilio.
• Usimamizi wa ujumbe kwa pamoja: Panga arifa kulingana na kifaa, programu na chanzo cha ujumbe, kisha uruhusu Agent wa kifaa lengwa cha Android kujibu ujumbe.
• Usanidi wa pamoja: Simamia kumbukumbu, ujuzi, kazi zilizopangwa na mfuatano wa vitendo, ukichagua kifaa kimoja au kufanya vitendo kwa pamoja.
• Usimamizi wa miunganisho: Inasaidia ugunduzi kwenye mtandao wa ndani, idhini ya kwanza, kuunganisha kwa mbofyo mmoja, kuunganisha tena baada ya kukatika, kubadilisha majina ya vifaa na gridi ya vifaa.

Maandalizi kabla ya kusakinisha

Mahitaji ya vifaa na mfumo

• Andaa angalau kifaa kimoja cha Android kitakachotumika kama kifaa cha utekelezaji.
• Kifaa cha udhibiti kinaweza kuwa iPhone au kifaa cha Android.
• Kifaa cha udhibiti na vifaa vya utekelezaji lazima viunganishwe kwenye mtandao mmoja wa ndani.
• Toleo la chini la Android ni Android 11. Uwezo halisi wa vitendo pia utaathiriwa na toleo la mfumo na mipangilio ya ruhusa.
• Toleo la chini la iOS ni iOS 17. Kwa sasa, inahitaji kujengwa, kusainiwa na kusakinishwa kupitia Xcode.

Chagua kifurushi sahihi cha usakinishaji

Watumiaji wa Android wanaweza kupakua phongent.apk kwenye ukurasa wa matoleo wa mradi. Tumia muundo uliotolewa na mradi wa phongent; usitumie APK ya mradi wa chanzo badala yake, kwa kuwa toleo la chanzo linaweza kukosa violesura vinavyohitajika kwa udhibiti wa vifaa vingi.

Usanidi na uunganishaji wa haraka

1. Sakinisha programu. Sakinisha APK ya phongent kwenye kifaa cha Android. Kifaa cha udhibiti cha iOS kinahitaji kujengwa na kusainiwa kwa Xcode kwenye macOS.
2. Sanidi kifaa cha utekelezaji cha Android. Kwenye programu, sanidi muundo unaohitajika na uwezo wa kuendesha vitendo kwenye simu, kisha toa ruhusa kama vile ufikivu na usomaji wa arifa kulingana na vipengele vinavyotumika. Mipangilio ya vitendo vya simu inaweza kuangaliwa kwenye mwongozo wa usanidi wa mradi.
3. Weka huduma ya kifaa cha utekelezaji ikiendelea. Thibitisha kuwa huduma ya Android imeanzishwa, na uunganishe kifaa cha udhibiti pamoja na kifaa cha Android kwenye mtandao mmoja wa ndani.
4. Unganisha vifaa. Kwenye ukurasa wa “Vifaa” wa kifaa cha udhibiti, chagua kifaa cha Android kilichogunduliwa au utumie “Unganisha kwa mbofyo mmoja”. Wakati wa kuunganisha mara ya kwanza, thibitisha idhini kwenye kifaa cha Android.
5. Sanidi muundo wa kifaa cha udhibiti. Fungua mipangilio ya kifaa cha udhibiti na usanidi muundo unaohusika na kuelewa na kutuma kazi. Akaunti za programu husika zinahitaji kuingia kwenye vifaa vinavyolingana vya utekelezaji.
6. Anza ushirikiano. Fungua ukurasa wa “agent”, chagua vifaa vyote, kikundi kimoja cha vifaa au kifaa kimoja, kisha ingiza kazi kwa lugha ya kawaida.

Baada ya kifaa kuidhinishwa mara ya kwanza, kinaweza kuunganishwa tena baada ya kukatika. Ikiwa kifaa hakigunduliwi, kagua kwanza muunganisho wa mtandao wa ndani na hali ya huduma ya Android badala ya kusakinisha programu tena mara moja.

Tambua sehemu nne kuu

• Vifaa: Gundua, unganisha, badilisha majina na panga vifaa vya Android.
• agent: Gawa kazi na tazama maendeleo ya utekelezaji, matokeo na dirisha dogo la moja kwa moja.
• Ujumbe: Tazama arifa kulingana na kifaa, programu na chanzo, na anzisha kazi za kujibu.
• Mipangilio: Sanidi muundo wa kifaa cha udhibiti, uwezo wa kifaa cha utekelezaji na chaguo zinazohusiana za ulandanishi.

Matumizi ya msingi: Tuma kazi kwenye vifaa

Gawa kazi tofauti kwa vifaa tofauti

Tuseme majina ya vifaa ni A na B. Unaweza kueleza moja kwa moja kwenye kazi kile ambacho kila kifaa kinapaswa kufanya:

A fungua ukurasa wa mwanzo wa Xiaohongshu na upige picha ya skrini, B fungua kivinjari na uangalie hali ya hewa ya leo.

Baada ya kutuma, unaweza kutazama maendeleo na matokeo ya kila kifaa. Ikiwa unahitaji kuchunguza au kusahihisha vitendo kwenye Android, fungua dirisha dogo la moja kwa moja la kifaa husika na udhibiti kifaa kwa kubofya, kutelezesha au kuandika.

Ushirikiano wa pamoja kwa vikundi vya vifaa

Kwa kazi zinazorudiwa kama uzalishaji wa maudhui, ukaguzi au uendeshaji, unaweza kuunda kikundi cha vifaa kwanza, kisha kutumia jina la kikundi kugawa kazi:

Kikundi cha maudhui kiunde rasimu ya maelezo ya bidhaa, na kikundi cha ukaguzi kitazame hali ya kazi za vifaa vyote.
A ndani ya kikundi cha maudhui ibadilishe kazi na kupanga nyenzo zilizopo, huku vifaa vingine vikiendelea kuunda rasimu.

Aina hii ya maelezo inaweza kuweka lengo moja kwa kikundi kizima, au kubadilisha kazi ya kifaa kimoja ndani ya kikundi.

Unda na sambaza maudhui tofauti

Unapotaka kila kifaa kishughulikie nyenzo tofauti, unaweza kuomba muundo wa kifaa cha udhibiti uunde maudhui tofauti, kisha uyatume kwa kila kifaa:

Kwa kila kifaa katika kikundi cha maudhui, unda kichwa, mwili wa maandishi na kadi ya picha yenye maandishi tofauti,
vitume kwa kifaa husika, vihifadhi kama rasimu na usivichapishe bado.

Kuongeza masharti kama “hifadhi kama rasimu, usichapishe bado” kwenye kazi husaidia kueleza mipaka inayotarajiwa ya vitendo. Utekelezaji halisi bado hutegemea usanidi wa muundo, hali ya programu lengwa, hali ya kuingia kwa akaunti na ruhusa za mfumo zilizotolewa.

Unda na simamia vikundi vya vifaa

1. Fungua ukurasa wa “Vifaa”. Gridi iliyo chini itaonyesha vifaa vilivyounganishwa kwa sasa, pamoja na jina na kikundi cha kila kifaa.
2. Bofya “Vikundi” na uchague vifaa unavyotaka kusimamia.
3. Chagua kikundi kilichopo au unda kikundi kipya.
4. Bofya “Hamisha vifaa N” ili kukamilisha uhamishaji wa pamoja.

Kila kifaa kinaweza kuwa kwenye kikundi kimoja pekee. Baada ya kuhamishwa, kitaondoka kwenye kikundi chake cha awali. Vifaa ambavyo havijapangwa kwa mikono vitawekwa kwenye “Kikundi chaguo-msingi”.

Bonyeza kwa muda avatar au kadi ya kifaa ili kubadilisha jina la kifaa au kukihamisha kwenye kikundi kingine. Kubadilisha jina la kifaa kutajaribu kulandanisha jina hilo na programu ya Android inayolingana, lakini kifaa cha utekelezaji lazima kiunge mkono kiolesura husika.

Maelezo ya vikundi huhifadhiwa kwenye kifaa cha sasa cha udhibiti na hayalandanishwi kiotomatiki na kifaa kingine cha udhibiti. Katika mazingira yenye vifaa vingi vya udhibiti, kila kifaa cha udhibiti lazima kisimamie vikundi vyake kivyake.

Tazama na jibu arifa kwa pamoja

phongent inaweza kusoma arifa za Android zilizoidhinishwa na kuzipanga kulingana na kifaa, programu na chanzo cha ujumbe. Baada ya kufungua ukurasa wa “Ujumbe”, unaweza kutazama maelezo ya arifa na kukabidhi kazi ya kujibu kwa Agent wa kifaa husika cha Android.

1. Hakikisha kifaa lengwa cha Android kimeruhusiwa kusoma arifa.
2. Fungua sehemu ya “Ujumbe” kwenye kifaa cha udhibiti.
3. Tafuta arifa lengwa kulingana na kifaa, programu au chanzo.
4. Fungua maelezo ya arifa na uanzishe kazi ya kujibu.
5. Agent kwenye kifaa lengwa cha Android akamilishe kitendo halisi cha kujibu.

Ikiwa kifaa cha udhibiti hakionyeshi arifa, kagua kwanza ruhusa ya kusoma arifa kwenye kifaa lengwa cha Android, huduma ya utekelezaji na hali ya muunganisho.

Mbinu za matumizi ya juu

Fanya maelezo ya kazi yawe rahisi kutekeleza

• Andika jina la kifaa au kikundi kwa uwazi: Kwa mfano “kikundi cha maudhui”, “kikundi cha ukaguzi” au “kifaa A”.
• Gawanya malengo tofauti: Eleza kwa uwazi kitendo cha kila kifaa; usichanganye mahitaji ya vifaa vingi kwenye sentensi isiyoeleweka.
• Taja hali ya mwisho: Kwa mfano “rudi na matokeo baada ya kupiga picha ya skrini”, “hifadhi kama rasimu” au “usichapishe bado”.
• Badilisha kazi ndani ya kikundi: Gawa lengo kwa kikundi kizima kwanza, kisha eleza pekee kile ambacho kifaa fulani kinapaswa kufanya tofauti.
• Kagua akaunti kwanza: Kwa programu za wahusika wengine, ingia kwenye akaunti mapema kwenye kifaa husika cha Android.

Tumia dirisha dogo la moja kwa moja kwa busara

Dirisha dogo la moja kwa moja linafaa kwa kuchunguza mchakato wa vitendo vya Agent au kuchukua udhibiti mwenyewe ukurasa unapobadilika wakati wa uendeshaji wa kiotomatiki. Huwashwa kwa chaguo-msingi; ikiwa huhitaji skrini ya moja kwa moja, unaweza kulizima kwenye mipangilio.

Simamia vifaa vya utekelezaji kwa pamoja

Mipangilio ya kumbukumbu, ujuzi, kazi zilizopangwa na mfuatano wa vitendo inaweza kusimamiwa kwa pamoja, na unaweza kuchagua kifaa kimoja au vifaa vingi kulingana na kipengele. Kabla ya kubadilisha mipangilio kwa pamoja, thibitisha wigo wa vifaa vilivyochaguliwa ili kuepuka kutumia mipangilio ya kifaa kimoja kwenye kikundi kizima.

Shughulikia matatizo ya muunganisho

• Thibitisha kuwa kifaa cha udhibiti na kifaa cha utekelezaji viko kwenye mtandao mmoja wa ndani.
• Thibitisha kuwa huduma ya kifaa cha Android cha utekelezaji bado inaendelea.
• Wakati wa kuunganisha mara ya kwanza, kamilisha idhini kwenye kifaa cha Android.
• Kifaa kilichoidhinishwa kikikatika, jaribu kukiunganisha tena au tumia “Unganisha kwa mbofyo mmoja”.
• Gridi ya vifaa huonyesha vifaa vilivyounganishwa pekee; kifaa kisichoonekana hakimaanishi kuwa kimeunganishwa kwa mafanikio.

Jenga toleo la Android kutoka kwenye msimbo wa chanzo

Programu ya Android ya mradi, kiolesura cha udhibiti na huduma ya kifaa cha utekelezaji ziko kwenye app/, huku uwezo mkuu wa Agent ukiwa kwenye core/. Ujenzi unahitaji JDK 17 na Android SDK, na kwa sasa hutumia compileSdk 36.

./gradlew :app:assembleDebug

APK ya utatuzi itatengenezwa kwenye app/build/outputs/apk/debug/. Kabla ya kusakinisha, thibitisha kuwa kifurushi kilichojengwa kimesainiwa kwa saini yako ya uundaji.

Jenga kifaa cha udhibiti cha iOS kutoka kwenye msimbo wa chanzo

Ujenzi wa iOS unahitaji macOS na Xcode inayounga mkono SDK inayotumiwa na mradi. Toleo la chini la usambazaji ni iOS 17.

1. Fungua ios/MikaRemote.xcodeproj kwa Xcode.
2. Chagua scheme ya MikaRemote.
3. Chagua timu yako ya uundaji kwenye mipangilio ya kusaini.
4. Unganisha iPhone lengwa, kisha jenga na usakinishe.

Saraka ya ios/ kwenye hazina ina kifaa cha udhibiti cha iOS, vipengele na shughuli za moja kwa moja; tools/android-emulators/ hutoa zana za kuunganisha na kujaribu emulator za Android; mwongozo wa usanidi, itifaki na rekodi za uthibitishaji ziko kwenye docs/.

Taarifa ya usalama: Funguo za muundo, vitambulisho vya akaunti na nyenzo za kusaini za kifaa hazipaswi kuandikwa kwenye msimbo wa chanzo au kuwasilishwa kwenye hazina ya matoleo.

Muhtasari

phongent hupanga vifaa vingi vya Android kuwa mazingira ya utekelezaji ya Agent yanayoweza kusimamiwa kwa pamoja, na hukuwezesha kutumia iPhone au kifaa cha Android kama kifaa cha udhibiti. Baada ya kusanidi ruhusa za kifaa cha utekelezaji, muunganisho wa mtandao wa ndani na muundo wa kifaa cha udhibiti, unaweza kugawa kazi kwa kifaa kimoja, kikundi cha vifaa au vifaa vyote, huku ukitazama matokeo, skrini ya moja kwa moja na ujumbe wa arifa. Mradi umetengenezwa kwa msingi wa Mika na hutumia Apache License 2.0.