Etusivu Etusivu / Insights / Blogi

Miten itsenäiset ohjelmistotoimittajat integroivat tulostimet, skannerit, NFC:n ja asiakasnäytöt POS SDK:n kautta?

2026 Kirjoittaja : ZCS

Keskeiset ostokset

  • ● POS SDK tarjoaa laitekohtaisia ​​oheislaitteita; POS API yhdistää yleensä liiketoimintajärjestelmät, tilaukset, varaston, maksut tai pilvipalvelut.
  • ● AIDL erottaa Android-sovelluksen valmistajan palvelusta, mutta julkaistujen käyttöliittymämuutosten on pysyttävä taaksepäin yhteensopivina olemassa olevien asiakassovellusten kanssa.
  • ● Tulostimen, skannerin, NFC:n ja asiakasnäytön integraatiot vaativat erilliset ominaisuustarkistukset, elinkaaren hallinnan, virhekoodit ja laitteistosilmukkatestit.
  • ● Android 15 esitteli 16 kt:n sivukoon tuen, joten itsenäisten ohjelmistokehittäjien on auditoitava toimittajien SDK-pakettien sisällä olevat natiivit `.so`-kirjastot.

SDK-arkiston vastaanottaminen ei todista, että Android POS -integraatio on valmis tuotantoon. Itsenäisen ohjelmistovalmistajan on tunnistettava laitteistorajapinta, prosessiraja, tuettu versiotuple, vikakäyttäytyminen ja testitodisteet jokaisen oheislaitekutsun taustalla. Laajempaa laitetta, laiteohjelmistoa ja käyttöönottopinoa arvioivat tiimit voivat aloittaa tästä. Täysi Android POS -opas.

Ensimmäinen ero on paikallisen laitesopimuksen ja sitä ympäröivien liiketoimintajärjestelmien välillä.

POS SDK on versioitu laiteintegraatiopaketti, joka sisältää kirjastoja, palvelusopimuksia, esimerkkisovelluksia ja mallikohtaista dokumentaatiota. POS SDK sisältää paikallisia laitteita, kuten tulostimia, skannereita, NFC-lukijoita, korttiliitäntöjä ja toissijaisia ​​näyttöjä. Pilvipohjainen POS-API vaihtaa sen sijaan tilaus-, varasto-, asiakas- tai maksutietoja järjestelmien välillä.

Tämä erottelu antaa integraatiotiimille käytännöllisen lähtökohdan: yhdistää jokainen vaadittu funktio sen varsinaiseen omistajaan ennen sovelluskoodin kirjoittamista.

 

Kassapääte ilmaisella SDK:lla


1. Mikä on POS SDK ja mikä se ei ole?

POS SDK on sovellukseen liittyvä sopimus laitetoiminnoille, joita tavallinen Android ei tarjoa johdonmukaisesti. Android-päätelaitevalmistaja voi tarjota kirjaston, taustapalvelun, Intent-protokollan tai kaikkien kolmen yhdistelmän. Paketti muuntaa sovelluspyynnöt komennoiksi, jotka sisäänrakennettu tulostin, skanneri, kortinlukija, asiakasnäyttö tai suojattu järjestelmäkomponentti ymmärtävät.

Sana ”avoin” ei kuvaa yhtä teknistä standardia. Avoin POS SDK voi tarkoittaa, että pätevät asiakkaat voivat hankkia dokumentaatiota ja kirjastoja, että rajapinnat sallivat kolmansien osapuolten sovellusten käytön tai että saatavilla on jokin esimerkkilähdekoodi. Termi ei takaa julkisia latauksia, lähdekoodin käyttöä, mallien välistä yhteensopivuutta tai rajoittamattomia maksutoimintoja.


1.1. POS SDK ohjaa paikallista laitteistoa

Paikallinen laitteistohallinta on POS SDK:n määrittävä soveltamisala. Kuitin tulostuskutsu, skannerin laukaisukomento, NFC-tunnisteen takaisinsoitto, kassalaatikon pulssi, toissijaisen näytön päivitys tai laitetietojen kysely päättyy yleensä itse Android-päätelaitteella.

Kassasovellus voi edelleen lähettää tietoja pilvipalveluun ennen paikallista toimintoa tai sen jälkeen. Valmis tilaus voidaan synkronoida toiminnanohjausjärjestelmään, kanta-asiakasohjelman tulos voidaan hakea etärajapinnasta ja kuitti voidaan renderöidä pilvidatasta. Nämä verkkotoiminnot pysyvät erillään SDK-kutsuista, jotka siirtävät paperia tai aktivoivat skannerin.


1.2. POS-rajapinta yhdistää liiketoimintajärjestelmät

POS-rajapinta yhdistää yleensä palveluita fyysisten oheislaitteiden sijaan. REST, GraphQL, webhookit tai viestijonot voivat vaihtaa tuotteita, hintoja, tilauksia, varastotasoja, asiakkaita, työntekijöitä ja selvitystietoja. Todennus, hintarajoitukset, sivutus, idempotenssi ja verkon uudelleenyrityssäännöt hallitsevat tätä integraatiota.

Laitteisto- ja pilviliittymät voivat jakaa saman sovellustyönkulun ilman samaa vikamallia. Pilvipalvelun aikakatkaisu voi sallia jonossa olevan uudelleenyrityksen, kun taas tulostimen aikakatkaisu edellyttää paperin siirtämisen tarkistamista. Molempien käsitteleminen yleisenä "API-virheenä" voi luoda kaksoiskuittia, kadonneita skannauksia tai ristiriitaisia ​​tilaustiloja.


1.3. Maksu-SDK:lla on kontrolloitu tapahtumapolku

Maksu-SDK ei ole vaihdettavissa yleisen oheislaitteiden SDK:n kanssa. Maksukomponentti voi hallita EMV-lähimaksuytimiä ja -ytimiä, PIN-koodin syöttöä, avaintenhallintaa, isäntäviestintää, peruutuksia ja kuittitietoja sertifioidun arkkitehtuurin mukaisesti. Kauppiassovellus voi vastaanottaa hyväksytyn tuloksen ilman raakatietoja korttitiedoista.

Android-kassalaite voi avata NFC-lukijan kanta-asiakaskorteille ja varata lähimaksun erilliselle sertifioidulle sovellukselle. Sama erottelu voi koskea magneettijuova- ja sirukorttiliittymiä. Laitteiston läsnäolo siis todistaa vain komponentin olemassaolon, ei sitä, että jokin muu sovellus voisi käyttää sitä maksamiseen.


1.4. Android-kehysrajapinnat kattavat vain osan pinosta

Tavalliset Android-API-rajapinnat voivat käyttää joitakin ulkoisia oheislaitteita, mutta ne eivät voi korvata kaikkia valmistajan palveluita. USB-isäntä-, Bluetooth-, kamera-, NFC-tunniste- ja näyttörajapinnat tarjoavat yhteisiä alustaominaisuuksia. Sisäänrakennetut tulostimet, suojatut kortinlukijat, GPIO, sarjaportit, virranhallinta ja suojatut laiteasetukset vaativat usein toimittajan laiteohjelmistoa ja etuoikeutettuja palveluita.

Integraation tulisi valita kapein vaatimuksen täyttävä rajapinta. Tavallinen USB-skanneri voi toimia Androidin kautta ilman toimittajan SDK:ta, kun taas sisäinen lämpötulostin saattaa vaatia allekirjoitetun palvelupaketin. Vähemmän omistettuja riippuvuuksia yksinkertaistaa siirrettävyyttä, mutta tuetun palvelun ohittaminen voi poistaa tilaraportoinnin, kilpailunhallinnan tai takuutuen.


2. Mitä itsenäisen ohjelmistotoimittajan tulisi saada ennen integraation aloittamista?

Riippumattoman ohjelmistokehityspalveluntarjoajan tulisi saada todistusaineisto ennen kehitystyön arvioimista. Myyntilausunto, jonka mukaan SDK "tukee tulostinta, skanneria ja NFC:tä", jättää pois versiot, kokoonpanot, käyttöoikeudet ja virhesemantiikka, jotka määrittävät, voidaanko sovellus toimittaa.

Minimipakkauksen tulisi sisältää:

  • ● Sovelluksen vaatimat AAR-, JAR-, AIDL-, natiivikirjasto- tai protokollatiedostot
  • ● Esimerkkisovellus, joka rakennetaan dokumentoiduilla työkaluilla
  • ● API-viitemateriaali, joka sisältää parametrit, paluuarvot, takaisinkutsut ja virhekoodit
  • ● SDK-versio, julkaisupäivämäärä, tarkistussumma ja julkaisutiedot
  • ● Tuetut päätemallit ja laitteistoversiot
  • ● Tuetut Android-koontiversiot, laiteohjelmistojulkaisut ja laitepalveluversiot
  • ● Vaaditut käyttöoikeudet, allekirjoitukset, järjestelmäoikeudet tai sovellusten sallittujen luettelot
  • ● Tuetut prosessoriarkkitehtuurit ja mukana olleet natiivit `.so`-kirjastot
  • ● R8- tai ProGuard-säännöt, joissa koodin lyhentäminen vaikuttaa pakettiin
  • ● Tunnetut rajoitukset, vanhentuneet rajapinnat ja siirto-ohjeet
  • ● Toistettavien vikojen tukipolku

Yhteensopivuustieto on tärkeämpi kuin arkistotiedoston nimi. Kaksi samaa kaupallista mallinimeä kantavaa päätelaitetta voi sisältää erilaisia ​​tulostinmekanismeja, skannerimoduuleja, piirilevyversioita tai laiteohjelmistohaaroja. SDK voi kääntyä molemmille laitteille, mutta tietty metodi epäonnistuu ajonaikana toisessa kokoonpanossa.

Riippuvuussuhde tulisi kirjoittaa kokonaisena tuplena.

POS SDK -yhteensopivuustuple sisältää päätelaitteen mallin, laitteistoversion, Android-koontiversion, laiteohjelmistokoontiversion, laite-palvelun version, SDK-version ja asennetun oheislaitteen vaihtoehdon. Yhden elementin muuttaminen voi muuttaa käyttöoikeuksia, metodien toimintaa, binääriyhteensopivuutta tai virheiden käsittelyä, vaikka sovelluspaketti pysyisi muuttumattomana.

Tuo tuple muuttuu "tuetuksi" testattavaksi lausekkeeksi. Hankinta- tai suunnittelutiimi voi toistaa toimivan konfiguraation, hylätä dokumentoimattomat korvaukset ja tunnistaa osapuolen, jonka on tutkittava regressiota.

Esimerkkihakemuksen tulisi osoittaa sekä epäonnistumiset että onnistumiset. Yhden rivin tulostindemo osoittaa siirron toimivan ihanteellisissa olosuhteissa. Tuotantoesimerkin tulisi myös näyttää palveluyhteys, ominaisuuksien etsintä, tilan takaisinkutsut, peruutus, aikakatkaisujen käsittely, resurssien tyhjennys ja uudelleenyhteys.

Laajempi toimittajan arviointi kuuluu teknisen paketin tarkastelun rinnalle. avoimen API:n valmistajan tarkistuslista selittää, miten dokumentaatio, versiointi, tuki ja näytteen validointi vaikuttavat valmistajan päätökseen.


3. Mitä integraatioarkkitehtuuria POS SDK käyttää?

Prosessin raja määrittää, miten sovellus alustaa, kutsuu, valvoo ja palauttaa myyntipisteen oheislaitteen. Sovelluksen sisällä toimiva kirjasto toimii eri tavalla kuin etänä toimiva Android-palvelu, eikä kumpikaan toimi kuten sovelluksen suoraan käyttämä USB-laite.

liitäntä Suoritusajan raja Tyypillinen myyntipisteen käyttö Ensisijainen tekninen riski
AAR tai JAR Hakuprosessin sisällä Kääreet, mallit, apuohjelmat, suorat laitekutsut Riippuvuuskonfliktit, obfuskaatio, natiivikirjastojen yhteensopivuus
AIDL- tai Binder-palvelu Android-prosessien välillä Sisäänrakennettu tulostin, korttipalvelu, järjestelmänhallinta Palvelun löytäminen, sidonnan kuolema, uudelleenkytkentä, rajapintojen yhteensopivuus
Tarkoitus tai lähetys Viestin raja Skannauksen tulokset, käynnistimet, laitetapahtumat Kaksoistoimitus, puuttuvat tapahtumat, väärentäminen, elinkaaren ajoitus
USB Host Sovellus USB-päätepisteeseen Ulkoinen skanneri, tulostin, sarjaporttimuunnin Luvat, luettelointi, valtuudet, irrotuksen käsittely
Bluetooth: Sovellus paritettuun oheislaitteeseen Mobiilitulostin, skanneri, lisävaruste Suorituksenaikainen käyttöoikeus, pariliitos, alue, uudelleenyhdistämistoiminto
Sarja- tai RS232-liitäntä Toimittajan palvelu- tai laitesolmu Vaaka, finanssimoduuli, teollisuuden oheislaitteet Portin omistajuus, baudinopeus, I/O:n esto, protokolla-ristiriita
REST- tai pilvi-API Verkon raja Tilaukset, varasto, hallinta, maksujen orkestrointi Todennus, viive, idempotenssi, offline-käyttäytyminen


3.1. Prosessin sisäiset kirjastot tarvitsevat riippuvuuksien hallintaa

AAR- tai JAR-tiedostosta tulee osa sovelluksen koontiversiota. Integraatiotiimin on vahvistettava Maven- tai paikallistiedostoasennus, transitiiviset riippuvuudet, Android-API:n vähimmäistaso, Kotlin- tai Java-yhteensopivuus, natiivit kirjastot, manifest-merkinnät ja kutistussäännöt.

Binääritiedostojen lataus tulisi testata kaikilla tuetuilla ABI-tiedostoilla. Paketti voi kääntyä onnistuneesti ja silti epäonnistua sovelluksen käynnistyksen yhteydessä, koska laitearkkitehtuurille puuttuu natiivikirjasto. Myös kaksoisluokat, yhteensopimattomat tukikirjastot tai vanhoja riippuvuuksia niputtava SDK voivat estää koonnin ennen kuin laitteistokutsuja tapahtuu.


3.2. AIDL-palvelut tarvitsevat elinkaaren hallintaa

AIDL luo tyypitetyn sopimuksen asiakassovelluksen ja toisen prosessin palvelun välille. Androidin virallinen AIDL-palvelusopimus edellyttää, että asiakas ja palvelu jakavat rajapinnan määritelmän, ja julkaistujen muutosten on pysyttävä taaksepäin yhteensopivina.

Vankan kassajärjestelmän asiakkaan tulisi käsitellä sidontaa tilakoneena:

UNBOUND → BINDING → READY → BUSY
    ↑         ↓        ↓       ↓
    └──── FAILED ← DISCONNECTED

Sovelluksen ei pitäisi olettaa, että onnistunut sidonta pysyy voimassa koko vuoron ajan. Android voi lopettaa palveluprosessin, laiteohjelmisto voi käynnistää laitteistodaemonin uudelleen tai päivitys voi korvata palvelupaketin. `DeathRecipient`-komennon, katkaisukutsun tai vastaavan dokumentoidun toiminnon tulisi palauttaa sovitin palautettavaan tilaan.


3.3. Intent-integraatiot vaativat eksplisiittisen viestisopimuksen

Tarkoituspohjaiset skanneri- tai tulostinintegraatiot vaativat saman versiokurin kuin kirjasto. Sopimukseen kuuluvat toimintomerkkijono, pakettirajoitus, lisäominaisuudet, tietotyypit, vastaustoiminto, korrelaatiotunniste, käyttöoikeus, aikakatkaisu ja kaksoiskappaleiden toimitusperiaate.

Tunnetulle paketille osoitettu eksplisiittinen aikomus on turvallisempi kuin rajoittamaton lähetys. Korrelaatiotunniste antaa sovelluksen liittää vastauksen alkuperäiseen tilaukseen tai pyyntöön. Vastaanottajan tulisi myös hylätä odottamattomat lähettäjät tai väärin muotoillut hyötykuormat, kun alusta tarjoaa tarvittavat ohjausobjektit.


3.4. Toimittajasovitin pitää liiketoimintalogiikan siirrettävänä

Toimittajan sovittimen tulisi eristää omat kutsut kassa-alueelta. Tilausprosessin tulisi pyytää kuittia, skannausta tai näytön päivitystä sovelluksen omistaman käyttöliittymän kautta sen sijaan, että valmistajaluokat tuotaisiin näyttöjen, tietovarastojen ja yrityspalveluiden välillä.

interface ReceiptPrinter {
    fun capabilities(): PrinterCapabilities
    suspend fun status(): PeripheralStatus
    suspend fun print(job: ReceiptJob): PrintResult
    suspend fun cancel(jobId: String): CancelResult
    fun close()
}

Esimerkki on tarkoituksella geneerinen. Todellinen sovitin yhdistää sovellusrajapinnan dokumentoituun AAR-, AIDL-, Intent-, USB- tai sarjamuotoiseen sopimukseen. Abstraktion tulisi säilyttää hyödylliset toimittajan virheet sen sijaan, että se tiivistäisi jokaisen virheen totuusarvoiseksi tulokseksi.


4. Miten tulostinintegraatio tulisi toteuttaa?

Tulostinintegraation tulisi erottaa kuitin sisältö, asettelu, siirto, jonotus ja palautus. Näiden huolenaiheiden yhdistäminen yhden SDK-kutsun sisällä vaikeuttaa muotoilun testaamista ilman laitteistoa tai sen selvittämistä, onko epäonnistunut toiminto jo tuottanut paperin.


4.1. Luo kuittimalli ennen komentojen antamista

Kuittimallin tulisi kuvata liiketoiminnan sisältö riippumatta tulostinkomennoista. Rivikohdat, verot, alennukset, kokonaissummat, maksuviitteet, kauppiaan tiedot, QR-koodit ja lakiteksti kuuluvat strukturoituun objektiin. Renderöintiohjelma muuntaa sitten mallin tietyn tulostimen ominaisuuksien mukaiseksi.

Renderöintiohjelman on käytettävä selkeitä sääntöjä tulostettavalle leveydelle, merkistökoodaukselle, fontin skaalalle, sarakkeille, rivitykselle, kuville, viivakoodisymboliikalle, QR-virheenkorjaukselle, syöttöetäisyydelle ja leikkaukselle. Pikselitarkka tulostus yhdellä mekanismilla ei takaa samaa tulosta eri paperileveydellä tai tulostustiheydellä.


4.2. Sarjoita tulostimen käyttöoikeus

Yhden jonon tulisi omistaa kutakin fyysistä tulostinta. Samanaikaiset tilaus-, hyvitys-, keittiö- ja taustalla synkronoidut työnkulut voivat lomittaa tulosteita tai asettaa laitteistopalvelun varattuun tilaan. Yksi lähettäjä voi sarjoittaa töitä, tallentaa niiden tunnisteet ja näyttää edistymisen sovellukselle.

Jonon pysyvyys riippuu liiketoimintasäännöstä. Talous- tai maksukuitti saattaa vaatia pysyvän tallenteen ja hallitun uudelleentulostuslipun. Väliaikainen keittiötiketti voi sallia manuaalisen uudelleenyrityksen. Sovelluksen tulisi määritellä sääntö ennen automaattisten uudelleenyritysten käyttöönottoa.


4.3. Erota lähetys valmistumisesta

Menetelmän onnistunut palautus voi tarkoittaa vain sitä, että palvelu on hyväksynyt työn. SDK-dokumentaatiossa tulisi mainita, onko suoritus synkroninen, takaisinsoittoon perustuva, kyselyyn perustuva vai ei-saatavilla. Ilman tätä erottelua kassasovellus saattaa merkitä tilauksen tulostetuksi ennen kuin mekanismi syöttää paperia.

Tulostimen tiloihin tulisi sisältyä vähintään valmius, varattu, paperi lopussa, kansi auki, ylikuumeneminen, tiedonsiirtovirhe ja tuntematon. Sovitin voi yhdistää valmistajakohtaiset koodit näihin sovellustiloihin säilyttäen samalla alkuperäisen koodin ja viestin diagnostiikkalokeissa.


4.4. Testaa fyysiset vikaantumispolut

Tuotantotulostintestin on luotava todellisia laitteistovikoja. Testitapausten tulisi poistaa paperi kesken työn, avata kansi, täyttää jono liikaa, käynnistää palvelu uudelleen, käynnistää pääte uudelleen, peruuttaa työ ja katkaista virransyöttö lähetyksen jälkeen.

Merkkien kattavuus edellyttää myös fyysistä tulostusta. Pelkkä latinalainen teksti ei voi validoida kiinaa, arabiaa, thaita, aksenttisia merkkejä, valuuttasymboleita, oikealta vasemmalle kirjoitettua asettelua tai sekakielisiä kuitteja. Kuvan rasterointi voi olla varmistus, mutta se muuttaa nopeutta, muistin käyttöä ja tulostuslaatua.


5. Miten skannerin syöte tulisi normalisoida?

Skannerin integroinnin tulisi muuntaa useita syöttöpolkuja yhdeksi tapahtumamalliksi. Kameradekooderi, erillinen skannausmoottori, USB HID -skanneri ja Bluetooth-skanneri voivat kaikki palauttaa saman viivakoodin käyttämällä erilaisia ​​liipaisimia, ajoitusta ja siirtokäyttäytymistä.

Sovelluksen omistama tapahtuma voi sisältää:

ScanEvent
  rawData
  normalizedData
  symbology
  sourceId
  sourceType
  triggerType
  timestamp
  confidenceOrStatus


5.1. Kameraskannauksella ja laitteistoskannauksella on erilaiset rajoitukset

Kameran dekoodaus riippuu tarkennuksesta, valotuksesta, liikkeestä ja sovelluksen elinkaaresta. Sovellus omistaa esikatselun, käyttöoikeudet, dekooderin kokoonpanon ja ruudun käsittelyn. Erillinen skannausmoottori voi nopeuttaa tähtäystä ja laukaisua, mutta se voi palauttaa tuloksia toimittajan takaisinsoiton, näppäimistökiilan tai lähetyksen kautta.

Käyttöliittymän ei pitäisi olettaa, että jokainen skannaus tulee parhaillaan tarkennetusta kentästä. Globaali HID-skanneri voi syöttää merkkejä väärään ohjausobjektiin, kun taas lähetysvastaanotin voi toimittaa dataa, vaikka kassanäyttö ei olisi näkyvissä. Sovittimen tulisi reitittää tapahtumat sovelluksen tilan mukaan.


5.2. Kaksoiskappaleiden hallinta kuuluu kuljetuksen yläpuolelle

Kaksoiskappaleiden estämisessä tulisi ottaa huomioon hyötykuorma, lähde, aikaikkuna ja liiketoimintakonteksti. Kiinteä viive voi virheellisesti hylätä kaksi saman tuotteen laillista skannausta. Parempi sääntö erottaa nopean laitteistotoiston tahallisesta toisesta määräskannauksesta.

Etuliitteiden, jälkiliitteiden, rivinloppujen, koodisivun muunnoksen ja tarkistusnumeroiden käsittelyn tulisi olla konfigurointia eikä hajanaisten merkkijonojen siivousta. Raaka-arvon on oltava saatavilla lokeissa, jotta tukitiimit voivat erottaa skannerin konfiguroinnin sovelluksen normalisoinnista.


5.3. Ominaisuuden löytäminen estää virheelliset oletukset

Sovelluksen pitäisi havaita, onko skannausmoottori asennettu ja käytössä. Valinnaiset moduulit luovat kokoonpanoja, joissa kaupallisen laitteen nimi pysyy vakiona, mutta skanneri puuttuu. Sovellus voi poistaa laitteistokäynnistysvaihtoehdon käytöstä ja tarjota kameraskannausta sen sijaan, että odotettaisiin soittoa, jota ei koskaan saavu.

 

Ota meihin yhteyttä


6. Miten NFC- ja kortinlukijat tulisi erottaa toisistaan?

NFC-tunnisteiden käyttö ja kontaktiton maksu ovat eri järjestelmiä. Android voi altistaa NFC-tunnistetekniikoita sovellukselle, kun taas maksusertifioitu komponentti hallitsee EMV-tapahtumia rajoitetun ytimen ja maksupalvelun kautta.

Kyvykkyysraja voidaan jakaa neljään tasoon:

  1. NDEF- tai omat NFC-tunnisteet, joita käytetään kanta-asiakasohjelmaan, tunnistamiseen tai konfigurointiin
  2. ISO/IEC 14443 -tiedonsiirto tuettujen korttiteknologioiden kanssa
  3. Android-lukijatila tai isäntäkortin emulointi
  4. Sertifioitu EMV-lähimaksu hyväksytyn maksuratkaisun kautta

Android NFC-lukutila rajoittaa etualan toiminnan taginlukijan toimintaan ja palauttaa löydetyt tagit takaisinkutsun kautta. API ei tarjoa EMV-ydintä, maksuavaimia, kauppiaiden maksutapahtumien vastaanottoa tai järjestelmän hyväksyntää.

Maksuraja on siis sopimuspäätös, ei NFC-metodikutsu.

NFC-tuki ei tarkoita, että POS SDK voi hyväksyä kontaktittomia pankkikortteja. Android-lukijatila paljastaa tuetut tunnisteteknologiat etualalla olevalle sovellukselle, kun taas EMV-hyväksyntä vaatii lisäksi maksuytimen, suojatut tunnistetiedot, sertifioidun laitteiston ja ohjelmiston, tapahtuma-isännän integroinnin sekä hyväksynnän aiotulle markkinalle ja ostajalle.

Tämän eron tulisi näkyä vaatimuksissa ja hyväksymistesteissä. Kanta-asiakaskortin esittely ei voi validoida lähimaksua, eikä maksusovelluksen tulos tarkoita, että kauppiassovellus saa matalan tason pääsyn NFC-ohjaimeen.


6.1. Siru- ja magneettilukijat tarvitsevat saman rajapinnan

Fyysinen ICC- tai MSR-paikka ei määritä sovellusliittymää. Yleiskäyttöinen SDK voi paljastaa kortin läsnäolotapahtumia tai muita kuin maksukorttitoimintoja, kun taas turvallinen maksupalvelu hallitsee rahoituskorttitietoja. Sallittu polku riippuu laitteistoarkkitehtuurista, tietoturvakäytännöstä, sertifioinneista ja maksutapahtumien vastaanottoratkaisusta.

ISV:n tulisi pyytää vastuukaavio, joka näyttää kauppiassovelluksen, laitepalvelun, maksusovelluksen, maksuytimen, suojatut komponentit ja isännän. Kaavion tulisi yksilöidä, mikä rajapinta palauttaa hyväksytyn summan, vastauskoodin, tapahtumaviitteen ja kuittikentät paljastamatta kiellettyjä tietoja.


7. Miten asiakasnäyttöjä tulisi ohjata?

Asiakkaan ja näytön integrointi alkaa näyttötopologian tunnistamisella. Toinen paneeli voi peilata ensisijaista näyttöä, näkyä Android-esitysnäyttönä, suorittaa erillisen toiminnon tai hyväksyä komentoja valmistajan palvelun kautta. Kahden paneelin fyysinen läsnäolo ei paljasta, mikä ohjelmistomalli on kyseessä.

kahden näytön POS-arkkitehtuuri tarjoaa laitteiston ja työnkulun kontekstin. SDK-integraation on sitten määritettävä, miten sovellus löytää, käsittelee, päivittää ja palauttaa asiakkaalle suunnatun paneelin.


7.1. Käsittele näyttöä dynaamisena resurssina

Asiakkaan näyttö voi tulla näkyviin, kadota tai sen kokoonpano voi muuttua sovelluksen elinkaaren aikana. Sovelluksen tulisi kuunnella näyttömuutoksia, luoda uudelleen näyttökohtaiset resurssit ja palauttaa nykyinen ostoskorin tai maksun tila yhteyden uudelleenmuodostuksen jälkeen.

Näyttötunnuksen kovakoodaus tai pelkän mallinimen tarkistaminen aiheuttaa haurasta toimintaa. Näyttötunnukset voivat muuttua käynnistyksen tai palvelun uudelleenkäynnistyksen aikana, ja eri laitteistokokoonpanoilla voi olla sama kaupallinen malli. Ominaisuuksien etsintä ja dokumentoidut näyttöluokat ovat turvallisempia kuin kiinteä numeerinen tunnus.


7.2. Pidä asiakkaan tila erillään kassan tilasta

Asiakkaan näytön tulisi käyttää rajoitettua näkymämallia. Tuotekuvaukset, määrät, hinnat, alennukset, kanta-asiakasohjelmakehotteet, suostumusrajoitukset ja maksutilanne voidaan näyttää paljastamatta henkilöstön hallintalaitteita, diagnostiikkaviestejä, asiakastietoja tai salaisia ​​sovellustiloja.

Asiakkaan näytön on oltava määritelty toimintamalli valmiustilassa, ostoskorissa, maksuvälineenä, valtuutuksena, hyväksyttynä, hylättynä, hyvityksenä ja offline-tilassa. Tyhjä tai vanhentunut näyttö maksun aikana voi aiheuttaa epävarmuutta, vaikka tapahtuma onnistuisikin.


7.3. Testikonfiguraatioon ja yksityisyyteen liittyvät virheet

Kahden näytön testauksen on sisällettävä elinkaari- ja yksityisyystapahtumat. Kierrä päätoimintoa, lukitse ja avaa laite, irrota näyttö, käynnistä näyttöpalvelu uudelleen, muuta tiheyttä ja keskeytä maksu. Varmista, että arkaluontoiset tiedot katoavat oikeassa siirtymässä ja että kosketussyöte ei ulotu kassatyöntekijöiden toimintoihin.

 

 


8. Miten USB-, Bluetooth- ja sarjaporttilaitteita tulisi käsitellä?

Ulkoiset oheislaitteet vaativat siirtokohtaisen käyttöoikeuden ja palautuslogiikan. Toimittajan SDK voi rivittää nämä polut, mutta sovelluksen on silti ymmärrettävä, mikä komponentti omistaa luetteloinnin, yhteyden ja virheiden korjauksen.


8.1. USB tarvitsee identiteetin, käyttöoikeudet ja irrotuskäsittelyn

Android USB Host tunnistaa laitteet kuvaajien, rajapintojen ja päätepisteiden avulla. Viralliset Android USB -isäntäsovellusliittymä käyttää `UsbManageria` luetteloidakseen ja kommunikoidakseen liitettyjen laitteiden kanssa, kun taas sovellussuodattimet voivat vastata toimittajan tunnusta, tuotetunnusta, luokkaa, alaluokkaa tai protokollaa.

USB-hyväksyntätestauksen tulisi kattaa:

  • ● Laitteen liittäminen ennen sovelluksen käynnistämistä ja sen jälkeen
  • ● Käyttäjän luvan epääminen ja myöhempi hyväksyminen
  • ● Useita oheislaitteita, joilla on sama tuotetunnus
  • ● Kaapelin irrottaminen komennon aikana
  • ● Uudelleenliittäminen ilman sovelluksen uudelleenkäynnistystä
  • ● Riittämätön väyläteho
  • ● Telakointiaseman tai keskittimen toiminta
  • ● USB-portti on virheenkorjauksen tai muun palvelun käytössä.

Laitespesifikaatioiden on myös vahvistettava, että portti toimii vaaditussa isäntä- tai lisälaitetilassa. Android-alustan tuki ei lisää isäntävirtaa tai sähköreititystä laitteistoon, josta sitä ei puutu.


8.2. Bluetooth tarvitsee Android-versiokohtaiset käyttöoikeudet

Bluetoothin toiminta riippuu kohde-SDK:sta, Android-versiosta, profiilista ja pariliitosmallista. Android 12:een tai uudempaan käyttöjärjestelmään kohdistuvat sovellukset tarvitsevat asiaankuuluvat skannaus-, yhteyden muodostamis- tai mainostusoikeudet. Paritettu laite voi silti sammua, olla kantaman ulkopuolella, olla liitettynä toiseen päätelaitteeseen tai muodostaa yhteyden odottamattoman profiilin kautta.

Sovittimen tulisi erottaa etsintä yhteydestä ja yhteys komennon suorittamisesta. Automaattinen uudelleenyhteyden muodostaminen vaatii rajoitetun käytännön, jotta puuttuva tulostin ei estä uloskirjautumista loputtomiin tai kuluta päätelaitteen akkua jatkuvan skannauksen vuoksi.


8.3. Sarjaprotokollat ​​vaativat tiukan kehyksen

RS232- ja sarjaportin kautta USB-integraatiot vaativat selkeät tiedonsiirtoparametrit. Tiedonsiirtonopeus, databitit, stop-bitit, pariteetti, koodaus, pakettien rajat, tarkistussummat, kuittaukset, aikakatkaisut ja uudelleenyrityssäännöt kuuluvat rajapinnan spesifikaatioon.

Sarjaportin lukijan silmukan ei tulisi estää Androidin pääsäiettä. Toteutuksen tulisi myös käsitellä osittaisia ​​kehyksiä, useita kehyksiä yhdessä puskurissa, vioittuneita paketteja ja oheislaitetta, joka nollautuu sulkematta porttia puhtaasti.


9. Miten itsenäisen ohjelmistotoimittajan tulisi suunnitella toimittajan sovitinkerros?

Ominaisuuskeskeinen sovitin vähentää useiden päätelaiteperheiden tukemisen kustannuksia. Abstraktion tulisi kuvata sovelluksen tarpeita sen sijaan, että se jäljittelisi ensimmäisen integroidun SDK:n metodien nimiä.

interface PosCapabilities {
    val printer: PrinterCapabilities?
    val scanner: ScannerCapabilities?
    val nfc: NfcCapabilities?
    val customerDisplay: DisplayCapabilities?
}

interface PosDeviceAdapter {
    suspend fun initialize(): InitResult
    fun capabilities(): PosCapabilities
    fun observeStatus(): Flow<DeviceStatus>
    suspend fun recover(): RecoveryResult
    fun close()
}

Sovitinkerroksen ei tulisi taata väärää yhdenmukaisuutta. Sisäänrakennettu tulostin voi raportoida paperin ja lämpötilan tilan, kun taas Bluetooth-tulostin raportoi vain yhteystilan. Jaettu malli voi merkitä ei-tuetut kentät sen sijaan, että se muodostaisi vastaavan tuloksen.


9.1. Pidä kykytarkistukset suorituksen aikana

Suorituksenaikaisten ominaisuuksien etsintä suojaa yhtä sovelluskoontia valinnaisissa kokoonpanoissa. Pelkät käännösaikaiset liput eivät pysty havaitsemaan korvattua skannerimoduulia, käytöstä poistettua palvelua, poissaolevaa asiakkaan näyttöä tai käyttöönoton jälkeen peruutettua käyttöoikeutta.

Sovellus voi tallentaa istunnon vakaat ominaisuudet välimuistiin, mutta ne tulisi päivittää laiteohjelmistopäivityksen, palvelun uudelleenkäynnistyksen, telakointiaseman vaihdon tai oheislaitteen liittämisen jälkeen. Diagnostiikkanäytössä tulisi näkyä havaittu malli, laiteohjelmisto, palvelu, SDK ja oheislaitteen tila tukiajan lyhentämiseksi.


9.2. Säilytä valmistajan tiedot diagnostiikassa

Normalisoitujen sovellusvirheiden tulisi säilyttää alkuperäinen toimittajan todiste. Tukilokit tarvitsevat raakavirhekoodin, SDK-version, palvelupaketin, laiteohjelmiston koontiversion, menetelmän, kuluneen ajan, pyyntötunnuksen ja asiaankuuluvan laitteen tilan.

Henkilötietoja, korttitietoja, PIN-tietoja, avaimia ja arkaluonteisia tokeneita ei saa tallentaa yleisiin diagnostiikkalokeihin. Lokikirjausjärjestelmä tulee tarkistaa maksu- ja tietosuoja-arkkitehtuurin kanssa ennen pilottihankkeen käyttöönottoa.


9.3. Kääri alustojen väliset kehykset natiivien siltojen taakse

Flutter, React Native ja web-kuoret tarvitsevat edelleen hallitun natiivin Android-rajan. Alustakanava tai natiivimoduuli voi paljastaa sovelluksen omistaman ominaisuusrajapinnan, kun taas Kotlin tai Java omistaa AIDL-sidonnan, Intent-vastaanottimet, USB-käyttöoikeudet ja elinkaaren takaisinkutsutoiminnot.

Alustariippumaton taso ei saisi vastaanottaa raakoja Binder-objekteja tai toimittajakohtaisia ​​takaisinkutsutyyppejä. Vakaa tiedonsiirto-objekti ja asynkroniset tulosvirrat pitävät kehyspäivitykset erillään laite-palvelumuutoksista.


10. Miten virheitä, samanaikaisuutta ja elinkaarta tulisi hallita?

Oheislaitteiden virheet tarvitsevat taksonomian, joka ohjaa tietyn käyttäjän tai ohjelmiston vasteen. Yksittäinen `FAILED`-tulos ei anna käyttöliittymälle mitään perustetta päättää, yritetäänkö uudelleen, pyydetäänkö paperia, yhdistetäänkö palvelu uudelleen vai pysäytetäänkö tapahtuma.

Virheluokka esimerkki Oletussovellusvastaus
Capability Moduuli puuttuu tai komentoa ei tueta Poista toiminto käytöstä ja näytä määritystiedot
Lupa USB-, Bluetooth-, kamera- tai etuoikeutettu käyttöoikeus evätty Pyydä sallittua käyttöoikeutta tai laajenna konfigurointia
Saatavuus: Palvelu puuttuu, on poistettu käytöstä tai ei ole yhteydessä Sido laite uudelleen tai merkitse se ei-saatavilla olevaksi
Resurssi Tulostin on varattu tai portin omistaa toinen prosessi Jonota, odota tai näytä omistajuusristiriita
Kulutustarvikkeiden Paperi loppu tai kansi auki Keskeytä työ ja pyydä käyttäjän toimia
Lämpö- Tulostin ylikuumeni Odota palautumista lähettämättä kopioita
liikenne USB-irrotus, Bluetooth-katkos, sarjaliitännän aikakatkaisu Yhdistä uudelleen rajoitetun käytännön mukaisesti
Versio SDK ja palvelu eivät ole yhteensopivia Pysäytä kyseinen ominaisuus ja ilmoita versionumero
panos Virheellinen bittikartta, komento tai parametri Hylkää paikallisesti ja kirjaa kehittäjän todisteet
tuntematon Yhdistämätön toimittajan koodi Säilytä raakatiedot ja estä hallitsematon uudelleenyritys


10.1. Uudelleenyritys on liiketoimintapäätös

Uudelleenyritys on turvallinen vain, jos edellisen operaation tulos on tiedossa. Skannerin laukaisin voidaan usein antaa uudelleen. Kuittityö on saattanut tulostua kokonaan, vaikka valmistumiskutsun katoaminen tapahtui. Maksupyyntö saattaa vaatia tilakyselyn tai peruutuksen uudelleenlähetyksen sijaan.

Jokaisen komennon tulisi siksi dokumentoida idempotenssisääntönsä. Sovellus voi liittää oman pyyntötunnisteensa, tallentaa tilasiirtymät ja kysyä palvelulta tilaa, jos sitä tuetaan. Sokeat uudelleenyritykset eivät saisi koskaan olla yleispätevä palautusstrategia.


10.2. Työn estäminen ei kuulu pääketjuun

Tulostin-, sarja-, USB- ja huoltopuheluiden ei pitäisi jumittaa Android-käyttöliittymää. Jopa nopeaksi kuvattu SDK-menetelmä voi odottaa laiteohjelmistoa, mekaanista toimintoa, laitteen lukitusta tai prosessien välistä kommunikaatiota.

Sovittimen tulisi tarjota peruutettavissa olevia asynkronisia operaatioita, jos alla oleva rajapinta tukee peruutusta. Käyttöliittymän korutiinin peruuttaminen ei välttämättä peruuta fyysistä tulostustyötä, joten toteutuksessa on erotettava sovelluksen ja laitteiston välinen peruutus.


10.3. Sovelluksen elinkaari on osa sopimusta

Etualalla, taustalla, prosessissa tapahtuvalla kuolemalla, uudelleenkäynnistyksellä ja päivityksellä on oltava määritellyt tulokset. Vain näkyvän aktiviteetin rekisteröimä vastaanotin voi ohittaa skannerin tapahtumat. Pitkäikäinen palvelu voi säilyttää jonon, mutta tuo mukanaan omat uudelleenkäynnistykseen ja akkuun liittyvät rajoituksensa.

Arkkitehtuurin tulisi määrittää omistajuus kapeimmalle mahdolliselle elinkaarelle, joka pysyy luotettavana. Käyttöliittymän tila kuuluu näytölle, jaetut oheislaiteyhteydet voivat kuulua sovelluskohtaiselle hallintaohjelmalle ja pysyvän työn tila kuuluu pysyvään tallennustilaan, kun liiketoimintasäännöt vaativat palautusta.


11. Miten POS SDK:n yhteensopivuus tulisi testata?

Tuotantointegraatio tarvitsee matriisin, ei yhtä onnistunutta demonstraatiota. Matriisin tulisi kattaa kaikki tuetut päätelaitteet, laitteistoversiot, Android-koontiversiot, laiteohjelmistot, palvelut, SDK:t, sovellukset ja asennetut moduulit.

terminaali Laitteistoversio Android-versio firmware Palvelu SDK perifeerinen Tulos
Testiyksikkö A Tallennettu arvo Tallennettu arvo Tallennettu arvo Tallennettu arvo Tallennettu arvo Tulostinvaihtoehto Hyväksytty, hylätty tai rajoitettu
Testiyksikkö B Tallennettu arvo Tallennettu arvo Tallennettu arvo Tallennettu arvo Tallennettu arvo Skannerivaihtoehto Hyväksytty, hylätty tai rajoitettu


11.1. Yksikkötestit kattavat sovelluksen omistaman logiikan

Yksikkötestien tulisi validoida renderöinti, normalisointi, tilasiirtymät ja virheiden kartoitus ilman fyysistä laitteistoa. Kuittisarakkeiden laskenta, kaksoiskappaleiden skannaussäännöt, uudelleenyritysten luokittelu, protokollan kehystys ja sovittimen toiminta voivat toimia väärennöksiä vastaan.

Testitulostinten ei pitäisi väittää vahvistavan itse SDK:ta. Väärennetyn tulostimen paluu onnistumiseen todistaa, että sovelluslogiikka käsittelee onnistumisen, ei sitä, että laiteohjelmisto tulostaa aiotut merkit tai raportoi paperin tilan oikein.


11.2. Instrumentaatiotestit kattavat Androidin rajat

Instrumentointitestien tulisi harjoitella käyttöoikeuksia, sidontaa, lähetyksiä, konfiguraatiomuutoksia ja prosessien uudelleenluomista. Testi-APK voi tarkistaa manifestin kokoonpanon, palveluiden löytämisen, callback-säikeistyksen ja toiminnan etualan ja taustan siirtymissä.

Testiympäristön tulisi tallentaa sama versiotuple, joka on suunniteltu tuotantoon. Emulaattori voi validoida sovellusarkkitehtuurin, mutta se ei voi korvata toimittajan palvelua ja sen hallitsemaa fyysistä oheislaitetta.


11.3. Laitteiston sisäiset testit kattavat fyysiset tulokset

Laitteisto-in-loop-testit yhdistävät ohjelmistotulokset paperiin, valoon, ääneen, kortteihin, viivakoodeihin ja näyttöihin. Testijohtosarja voi lähettää tunnetun työn, tallentaa takaisinsoittoja ja lokeja ja vaatia sitten käyttäjää tai anturia varmistamaan fyysisen tuloksen.

Hyödyllisimmät testit aiheuttavat tarkoituksella virheitä: poista paperia, peitä skannerin ikkuna, näytä ei-tuettuja tunnisteita, irrota USB, sammuta Bluetooth, käynnistä laitepalvelu uudelleen ja irrota asiakasnäyttö. POS-laitteiston vakaussäätimet tarjoavat laajemman valmistuskontekstin toistettavuudelle eri tuotantoyksiköissä.


11.4. OTA-regressiotestit suojaavat käyttöönotettuja laitekantoja

Jokaisen laiteohjelmisto- tai laitepalvelupäivityksen tulisi suorittaa kriittinen oheislaitepaketti uudelleen. Julkaisuportin tulisi tunnistaa hyväksytyt yhdistelmät, jäljellä olevat tunnetut rajoitukset ja onko peruutusmahdollisuus mahdollinen.

Vaiheittaisessa käyttöönotossa päivitys voidaan sijoittaa laboratoriolaitteisiin, sisäisiin pilottiyksiköihin, pieneen tuotantokohorttiin ja sitten laajempaan laitekantaan. Laitehallinta voi jakaa koontiversion, mutta vain regressiopaketti määrittää, säilyttääkö uusi versio sovelluksen toiminnan.


12. Mitä muuttui natiivien SDK-kirjastojen osalta modernissa Androidissa?

POS SDK:n natiivikirjastot voivat luoda yhteensopivuutta, vaikka sovellus olisi kirjoitettu kokonaan Kotlinilla tai Javalla. AAR voi sisältää `.so`-binääritiedostoja tulostinrenderöintiä, viivakoodien dekoodausta, kryptografiaa, kuvankäsittelyä tai laitekommunikaatiota varten.

Tämä altistuminen on helppo ohittaa, kun riippuvuus saapuu vain esikäänännettynä toimittajan binääritiedostona.

Android-kehittäjien nykyinen 16 kt:n sivukoko-ohje toteaa, että natiivikoodia suoraan tai SDK:n kautta käyttävien sovellusten on käytettävä yhteensopivia koontiversioita 16 kt:n laitteilla. Riippuvuustarkastuksen tulisi tarkastaa jokainen pakattu ABI ja jaettu kirjasto, ei pelkästään sovelluksen lähdekoodivarasto.

Alustan muutos luo konkreettisen hankintakysymyksen vuodelle 2026.

Kesäkuussa 2025 julkaistun Android 16 -julkaisuilmoituksen mukaan Android 16 lisäsi 16 kt:n sivukoon yhteensopivuustilan. Natiiveja SDK-kirjastoja pakkaavien myyntipistesovellusten on edelleen tarkistettava kohdistus, ABI-kattavuus, asennus, käynnistys ja oheislaitteiden toiminta kohde-Android-koontiversiossa sen sijaan, että yhteensopivuustilaa käsiteltäisiin pysyvänä validointina.

Tämä vaatimus kuuluu SDK:n hyväksymistietueeseen. Toimittajan tulee tunnistaa yhteensopiva pakettiversio ja itsenäisen ohjelmistokehitysyrityksen (ISV) tulee varmistaa oman koontiputkensa tuottama lopullinen APK tai sovelluspaketti.


12.1. Auditoi jokainen binäärinen riippuvuus

Riippuvuusraportin tulisi tunnistaa jokaisen natiivin kirjaston alkuperä ja versio. Nykyinen sovellus voi pysyä estettynä yhden vanhentuneen, valmiiksi rakennetun binääritiedoston vuoksi, joka on sisäkkäin oheislaitteiden SDK:ssa tai transitiivisessa kirjastossa.

Auditoinnin tulisi tallentaa tuetut ABI:t, kirjastotiedostonimet, paketin lähdekoodi, sivukoon tila, työkaluketjun odotusarvo ja korvaava polku. Toimittajan lausunto siitä, että terminaali käyttää Android 15:tä tai Android 16:ta, ei todista, että vanhempi SDK-binääritiedosto on yhteensopiva saman ympäristön kanssa.


12.2. Testaa julkaisuversiota, älä pelkästään debugaa

Julkaisuversiot voivat toimia eri tavoin allekirjoittamisen, kutistamisen, resurssien poiston ja optimoinnin vuoksi. Testiputken tulisi asentaa allekirjoitettu julkaisuehdokas, varmistaa palvelun sidonta ja heijastuspohjaiset API:t sekä suorittaa jokainen oheislaitepolku.

R8:n säilytyssäännöt, manifestien yhdistäminen, natiivipakkaus ja sovelluksen allekirjoittaminen voivat kaikki muuttaa tulosta. Onnistuneesti tulostuva debug-APK on hyödyllinen todiste, mutta se ei ole tuotannon hyväksyntäartefakti.


13. Miten SDK:n hyväksyntä tulisi kirjata hankintamenettelyyn?

SDK-tuotteella tulisi olla sopimukselliset hyväksymiskriteerit. Hankinnan ei tulisi käsitellä ohjelmiston käyttöoikeutta päätelaitteen hankinnan epävirallisena lisänä, kun ostajan sovellus on riippuvainen kyseisestä ohjelmistosta jokaisen kuitin, skannauksen ja asiakasvuorovaikutuksen osalta.

Hyväksymissuunnitelman tulisi edellyttää:

  • ● Nimetty SDK-paketti ja tarkistussumma
  • ● Tuettu versiotuple jokaiselle järjestetylle konfiguraatiolle
  • ● Esimerkkiprojekti, joka rakentuu sovitun työkaluketjun avulla
  • ● Dokumentaatio, joka kattaa jokaisen ostetun oheislaitteen
  • ● Toistettavat onnistumis- ja epäonnistumistestit
  • ● Täydellinen virhekoodien ja tilan viite
  • ● Määritellyt vastetavoitteet integraatiovirheiden estämiseksi
  • ● Ennakkoilmoitus rikkovista laiteohjelmisto- tai palvelumuutoksista
  • ● Pääsy korvaaviin, aiempiin ja peruutettaviin paketteihin, jos se on sallittua
  • ● Vanhenemis- ja tuen päättymiskäytäntö
  • ● Regressiotodisteet ennen tuotantolaiteohjelmiston julkaisua

Toimittajan tulee ilmoittaa poikkeukset yhtä selkeästi kuin tuetut ominaisuudet. Maksuytimen käyttöoikeus, etuoikeutetut asetukset, suojatut lukijat, finanssimoduulit, laitteen omistajan toiminnot tai järjestelmän allekirjoittaminen saattavat vaatia erillisiä sopimuksia ja hyväksyntöjä. Nimenomainen poissulkeminen estää myyntiominaisuusluettelon muuttumisen tukemattomaksi tekniseksi oletukseksi.

Laajempi toteutuskonteksti on kuvattu Android POS avoin SDK artikkeli. Tämän oppaan hyväksymisaikataulu lisää version ja testitodisteet, joita tarvitaan alustakonseptin muuntamiseksi julkaisupäätökseksi.


13.1. Arvioi SDK:ta toimitusmallia vasten

Laitteistoalustaa hallinnoivan osapuolen tulisi omistaa pienin ratkaisematon laitevika. Integroitu maksupalveluntarjoaja voi toimittaa laitteen, maksusovelluksen, prosessoriyhteyden ja tukikanavan yhdessä. Puhdas laitteistotoimittaja voi tarjota laiteohjelmiston ja oheislaiteliitännät, kun taas riippumaton ohjelmistotoimittaja omistaa kassasovelluksen ja maksukumppanuudet.

ZCS edustaa Pure-Hardware ODM/OEM POS -mallia itsenäisille ohjelmistokehittäjille (ISV), jotka toimittavat omia sovelluksiaan. Integrointi riippuu mallikohtaisesta SDK-paketista, päätelaitteen laiteohjelmistosta, Android-koontiversiosta ja asennetuista oheislaitteista; hankinnan on validoitava koko versiotuple sen sijaan, että hyväksyttäisiin yleinen lausunto avoimen SDK:n olemassaolosta.

Tämä toimitusmalli tarjoaa sovelluksen hallinnan, mutta tekee myös rajapinnan omistajuudesta näkyvän. Sopimuksessa tulisi yksilöidä, toistaako ja korjaako rajat ylittävän vian ZCS, ISV, maksupalveluntarjoaja vai jokin muu oheislaitetoimittaja.


13.2. Vahvista paketti ennen tuotantomäärän tilaamista

Esimerkkiterminaali ja sen tarkka SDK-paketti tulisi testata ennen tuotantokokoonpanon jäädyttämistä. ISV:n tulisi kääntää referenssisovellus, toteuttaa yksi vertikaalinen työnkulku, injektoida virheet ja tallentaa toimiva tuple.

Hyödyllinen vertikaalinen työnkulku skannaa tuotteen, päivittää ostoskorin, näyttää kokonaissumman asiakkaan näytöllä, avaa hyväksytyn maksupolun ja tulostaa kuitin. Työnkulku paljastaa eri laitteiden välisiä ajoitus- ja elinkaariongelmia, jotka yksittäiset demot voivat jäädä huomaamatta.

ZCS julkaisee tällä hetkellä Android POS SDK -lataukset sivu, jolla luetellaan Android POS -paketti Z90-, Z91-, Z92- ja Z100-laitteille sekä erillinen kortinlukijan SDK-merkintä. Sivulla määritetään tukiasema, mutta ostajan on silti hankittava ja tarkistettava edellä kuvatut pakettitason versiot, yhteensopivuus ja hyväksyntätiedot.

 

Lue lisää ZCS SDK -tuesta


14. Usein Kysytyt Kysymykset


K1. Mitä eroa on POS SDK:lla ja POS API:lla?

POS SDK ohjaa normaalisti paikallista päätelaitteistoa, kun taas POS API vaihtaa normaalisti liiketoimintatietoja järjestelmien välillä. Täydellinen kassasovellus voi käyttää molempia: SDK tulostaa tai skannaa laitteella ja API synkronoi tilaukset, tuotteet, asiakkaat tai maksut pilvipalveluiden kanssa.


K2. Käyttääkö jokainen Android POS SDK AIDL:ää?

Ei, Android POS SDK voi käyttää AIDL:ää, prosessin sisäistä AAR:ia tai JAR:ia, Intent-menetelmiä, lähetyksiä, suoraa USB- tai sarjaporttiyhteyttä tai useita menetelmiä yhdessä. SDK-dokumentaation tulisi tunnistaa kunkin toiminnon prosessirajat ja elinkaari.


K3. Voiko Android-sovellus ohjata sisäänrakennettua tulostinta ilman POS SDK:ta?

Sisäänrakennettu tulostin vaatii yleensä valmistajan tuetun palvelun tai kirjaston, koska Androidin standardiversiossa ei ole yhtä universaalia sisäisen tulostimen API:a. Suora ESC/POS- tai porttiyhteys saattaa toimia joissakin kokoonpanoissa, mutta tilaraportointi, kilpailunhallinta, käyttöoikeudet ja tuki voivat vaihdella.


K4. Salliiko NFC-rajapinta lähimaksut?

Pelkkä NFC-rajapinta ei valtuuta lähimaksuja korttimaksuihin. EMV-hyväksyminen riippuu myös maksuytimestä, suojatuista tunnistetiedoista, sertifioiduista komponenteista, maksusovelluksesta, isäntäintegraatiosta, järjestelmän vaatimuksista, hankkijasta ja kohdemarkkinoista.


K5. Miten Flutterin tai React Nativen tulisi kutsua POS SDK:ta?

Flutter- tai React Native -sovellusten tulisi käyttää pientä natiivia Android-siltaa sovelluksen omistaman oheislaiterajapinnan ympärillä. Kotlinin tai Javan tulisi hallita AIDL-sidontaa, käyttöoikeuksia, tavoitteita, USB:tä, elinkaarta ja toimittajan takaisinkutsuja, kun taas alustojenvälinen kerros vastaanottaa vakaat dataobjektit ja tapahtumat.


K6. Mitä Android POS SDK -paketin tulisi sisältää?

Käyttökelpoisen paketin tulisi sisältää kirjastoja tai palvelusopimuksia, API-dokumentaatiota, rakennettavan mallin, versiohistorian, virhekoodit, tuetun mallin ja laiteohjelmistomatriisin, käyttöoikeudet, natiivikirjaston tiedot, tunnetut rajoitukset, siirto-ohjeet ja teknisen tuen polun.


K7. Miten itsenäisen ohjelmistokehitysyrityksen tulisi testata laiteohjelmiston ja SDK:n yhteensopivuutta?

ISV:n tulisi testata tallennettu joukko päätelaitteen mallia, laitteistoversiota, Android-versiota, laiteohjelmistoa, laitepalvelua, SDK:ta, sovellusta ja asennettua oheislaitetta. Testaussuunnitelman tulisi sisältää normaali toiminta, fyysisen vian injektointi, uudelleenkäynnistys, prosessin kuolema, OTA-päivitys ja palautus.


K8. Voiko yksi POS SDK toimia kaikissa päätemalleissa?

Yksi liitäntä voi kattaa useita päätteitä vain, jos valmistaja dokumentoi ja testaa kyseisen yhteensopivuuden. Erilaiset tulostinmekanismit, skannerimoduulit, emolevyt, Android-koontiversiot ja laiteohjelmistopalvelut voivat luoda mallikohtaista toimintaa jaetun kaupallisen SDK-nimen taakse.


K9. Mitä tapahtuu, kun laitteistopalvelu katkeaa?

Sovelluksen tulisi merkitä kyseiset ominaisuudet käyttämättömiksi, säilyttää keskeneräisten töiden tila, sitoa uudelleen rajoitetun käytännön mukaisesti ja estää fyysisten toimintojen päällekkäisyydet. Käyttöliittymän tulisi paljastaa katkaisu- ja palautustapahtumat sen sijaan, että käyttöliittymä odottaisi loputtomiin.


K10. Miten SDK-päivitykset tulisi käsitellä käyttöönoton jälkeen?

SDK-päivityksen tulisi seurata riippuvuustarkastusta, julkaisutiedotteen analyysia, koontiversion varmennusta, laboratoriotestausta, pilottijulkaisua, tuotantovaiheistusta ja palautuksen valmistelua. Vastaavat laiteohjelmisto- ja laitepalveluversiot on hallittava sovelluspaketilla.


15. Lopullinen integrointisääntö

Luotettava POS SDK -integraatio hallitsee neljää asiaa: ominaisuuksia, käyttöliittymää, versiota ja todisteita. Ominaisuus (Capability) määrittää fyysisen toiminnon ja sen, onko se olemassa tilatussa kokoonpanossa. Rajapinta (Interface) määrittää kirjaston, palvelun, Intentin, USB:n, Bluetoothin tai sarjaportin rajan, jota käytetään sen saavuttamiseen.

Täydellinen versiotuple tekee integroinnista toistettavan. Päätelaitteen mallin, laitteistoversion, Android-koontiversion, laiteohjelmiston, laitepalvelun, SDK:n, sovelluksen ja oheislaitevaihtoehdon tulisi näkyä julkaisutietueessa. Yleinen mallinimi tai SDK-tiedostonimi ei riitä.

Vikatestaus muuntaa toimivan demon tuotantopäätökseksi. Paperin poisto, palvelun katkos, kaksoisskannaukset, NFC-virheellinen luokittelu, näytön irtoaminen, USB:n irrotus, Bluetooth-katkos, uudelleenkäynnistys ja OTA-päivitykset paljastavat olosuhteet, jotka aiheuttavat kenttäonnettomuuksia.

Lopullisen hyväksynnän tulisi hyväksyä hallittu kokoonpano, ei SDK-lupaus. Hyväksytty paketti sisältää dokumentaation, rakennettavat näytteet, versiotiedot, diagnostiikkatodisteet, palautumiskäytännöt, tuen omistajuuden, muutosilmoitukset ja asennetun laitekannan palautusjärjestelyt.

Onko sinulla kysyttävää? Kirjoita meille!
Ota yhteyttä
LISÄÄ: Huone 402, Dewisen-rakennus, nro 16, Gaoxin Nan Seventh Road, Nanshanin alue, Shenzhenin kaupunki, Kiina, 518000