OEM/ODM-tillverkare av smarta glasögon · Shenzhen, Kina +86 19835872450 sales@cynrin.com
OEM & ODM

Teknisk anpassning: frågor om appintegration

En begäran om appintegration i ett OEM-program för smarta glasögon kan verka liten på papper. Be fabriken att byta namn på menyn, ändra parningssidan och lägga till en…

Av CYNRINs ingenjörs- och inköpsgrupp/ Jul 17, 2024/ 19 min läsning
Teknisk anpassning: frågor om appintegration

En integrationsbegäran för en app i ett OEM-program för smarta glasögon ser liten ut på papper. Du ber fabriken att byta namn på menyn, ändra parkopplingsskärmen, lägga till ett språk och koppla fastvaran till din egen molntjänst. Sedan kommer offerten tillbaka, provmodellen anländer och telefonappen beter sig på sätt som ingen har dokumenterat.

Orsaken är strukturell. Arbete med fastvara och appar är inte en funktionsbegäran som kan läggas till en produkt som redan finns. Det är ett krav som måste frystas som alla andra krav, verifieras mot en referensmodell som alla andra krav och tas med i överensstämmelsefilen som alla andra krav. När en köpare behandlar appsidan som en bekvämlighet i ett sent skede stannar programmet vid provmodellens grind.

Den här artikeln beskriver vad en integrationsbegäran för en app kan och inte kan förändra, vilka förändringar som är utvecklingsarbete och vilka som är konfigurationsval, vad köparen måste tillhandahålla innan något apparbete börjar och hur förändringar på appsidan verifieras när provmodeller byggs och verifieras. Den är skriven för tekniska arbetsledare på varumärkessidan och inköpschefer för kanaler som behöver ställa exakta frågor till en leverantör innan en beställning utfärdas.

Om du fortfarande jämför programmodeller generellt börjar du med översikten över pelarna på /oem-odm och sedan utvecklingsramen för anpassning på /oem-odm/engineering-customization. Ramen är densamma för alla kategorier: krav frysts, löslighet granskad, utveckling och verktyg, provmodeller byggda och verifierade, överensstämmelsefil stängd och pilotkörning före massproduktion. Varje steg avslutas när det har producerat ett dokument.

Teknisk anpassning för appintegration genom sex grindar

Teknisk anpassning och appintegration: vad som förändras

Det ärliga sättet att tänka kring en integrationsbegäran för en app är att sortera varje rad till en av två kategorier. Den första kategorin är konfiguration: en förändring som fabriken kan tillämpa utifrån en befintlig version, utan ny fastvaruutveckling, nya verktyg eller en ny testcykel. Den andra kategorin är utvecklingsarbete: en förändring som kräver ny kod, en ny version, en ny verifieringscykel och en ny beskrivning av vad den levererade produkten gör.

Konfiguration i den första kategorin omfattar Bluetooth-enhetens namn som visas vid parkoppling, menyspråksuppsättningen, standardgränsen för volymen, enheterna som används på en inställningsskärm samt parkopplingsljudet eller den haptiska signalen, förutsatt att den underliggande funktionen redan finns i basfastvaran. Det är vanligtvis parameterändringar som tas med i en version som redan har validerats för hårdvaran den körs på. De måste fortfarande skrivas in i det frysta kravdokumentet, eftersom en parameter som inte står nedskriven är en parameter som ingen har kommit överens om.

Utvecklingsarbete i den andra kategorin omfattar alla förändringar som ändrar vad fastvaran gör i stället för hur en beteckning skrivs. En ny parkopplingsflöde, en ändrad kontrollmappning, en kamerafunktion som måste aktiveras med en annan gest, en fastvaruändring som måste överföra data till en annan server eller en förändring som måste klara en uppgraderingsväg för fastvara som ditt varumärke senare ansvarar för hamnar alla i den här kategorin. De är inte svårare för att de är programvara; de är svårare för att de förändrar vad verifieringen måste bevisa.

Det finns en tredje kategori som köpare ofta placerar fel. Vissa begäranden är varken konfiguration eller utvecklingsarbete hos fabriken – de är beslut som köparen måste fatta om ekosystemet kring produkten. Vilken appbutik programmet distribueras via, om köparen alls levererar en mobilapp eller konfigurerar en befintlig app, vem som driver serverdelen som fastvaran kommunicerar med och hur slutanvändare får fastvaruuppdateringar är alla svar som köparen ansvarar för. Fabriken kan implementera enligt en specifikation men kan inte fatta beslut om specifikationen. Vi tar fram dessa frågor innan kravdokumentet undertecknas, eftersom ett uteblivet svar här är det som förvandlar en okomplicerad integration till en försenad.

Det är värt att göra själva sorteringen skriftligt, eftersom svaret avgör vem som bär risken. En konfigurationsändring kräver liten ansträngning men ingår fortfarande i en version, och en version som innehåller en granskad parameterändring som inte har granskats måste identifieras med sin versionsbeteckning så att den kan spåras till vad som godkändes. En utvecklingsändring innebär en annan risk: den ändrar beteendet, och det är beteendet som verifieringsdokumentationen lovar om. När du sorterar begäran bestämmer du inte vad som är enkelt, utan vad som måste bevisas. Två leverantörer kan komma överens om samma funktionslista och ändå ta fram helt olika verifieringsomfång, och skillnaden visar sig senare som en diskussion om huruvida provmodellerna är godtagbara.

En användbar metod för den andra gruppen är att fråga vad som skulle vara observerbart annorlunda på enheten efter ändringen, och sedan fråga om leverantören kan beskriva den kontroll som skulle upptäcka skillnaden. En ändring som du inte kan beskriva någon kontroll för är ännu inte specificerad. Omvänt: om du kan beskriva kontrollen har du redan skrivit större delen av det tekniska arbetet, och det blir mycket lättare att jämföra offerter mellan leverantörer. Köpare som kommer med skrivna acceptanskrav förhandlar vanligtvis bättre än köpare som kommer med en önskelista över funktioner, eftersom avvägningen blir konkret: antingen verifieras det här beteendet, eller så ingår det inte i releasen, och båda ståndpunkterna är försvarsbara i en inköpsorder.

Det hjälver också att uttryckligen dokumentera vad som faller utanför omfattningen. Anpassningsprogram för programvara tenderar att växa eftersom det saknas skrivna gränser, så varje ny idé behandlas som en liten tillägg. En kort lista över saker som releasen inte kommer att göra — ingen molnsynkronisering i den här generationen, ingen integration med hälsoapplikationer från tredje part, inget stöd för flera konton — hindrar att verifieringsdokumentationen växer efter att golden sample har undertecknats och hindrar att pilotkörningen misslyckas på grund av en funktion som ingen definierade. Omfattning som skrivs som undantag är den billigaste kontrollen i hela programmet.

En användbar disciplin är att beskriva varje begärda ändring i en mening som börjar med "efter parkoppling kan användaren..." eller "när enheten laddas visar applikationen...". Om meningen inte kan avslutas utan att nämna en tjänst, ett konto eller en policy som ingen ansvarar för är begäran ännu inte redo att offereras. Det är fortfarande en idé, inte ett krav.

Sorterar appbegäran i konfiguration, teknik och köparbeslut

En sak till hör hemma här, eftersom den påverkar kostnaden och tidsplanen för allt ovanstående. Arbete med applikation och firmware är kopplat till hårdvaran som den körs på. En firmwareändring som påverkar strömförbrukning, radiobeteende eller minnesanvändning kan skicka produkten tillbaka genom de verifieringssteg som redan avslutats för hårdvaran. Ett varumärke som betraktar appbegäran som oberoende av hårdvaruplannen kommer att upptäcka detta i sämsta möjliga ögonblick, vilket vanligtvis är i provstadiet när golden sample redan har undertecknats.

AI-genererat fotografi som illustrerar teknisk anpassning: frågor om appintegration — bild 1 av 3

Det du måste tillhandahålla innan apparbetet börjar

En integration kan inte byggas utifrån antaganden. Innan steget för utveckling och verktyg inleds måste köparen lämna över en specifik uppsättning underlag, och det är rimligt att en leverantör säger att arbetet inte kan påbörjas förrän dessa finns. Att begära dem i god tid är inte att leverantören försenar arbetet; det är det enda sättet att anpassa en utvecklingsinsats till frysta krav i stället för till en gissning.

Det första underlaget är kontona och uppgifterna för autentisering. Det innebär utvecklarkonton för alla plattformar som applikationen eller firmwaren måste registreras hos, testkonton för backendtjänsten som enheten ska kommunicera med och testuppgifter för distributionskanalen i appbutiken. Om dessa finns hos köparen eller hos fabriken är i praktiken en kommersiell fråga och en fråga om incoterms, eftersom det avgör vem som får inneha en signeringsnyckel och vem som kan skicka en uppdatering i slutet av programmet.

Det andra underlaget är specifikationen för backendtjänsten. Firmwaren kommer att göra nätverksanrop, och varje anrop kräver en endpoint, en payloadstruktur, en autentiseringsmetod, ett felmeddelande och en förväntad tidsgräns. En leverantör som säger "skicka data till vår server" utan detta har inte lämnat någon specifikation. Begär ett skriftligt gränssnittsdocument och fråga vad som händer när servern inte är nåbar, eftersom en bärbar enhets felbeteende är mycket synligt för slutanvändare och måste vara ett beslut, inte en olycka.

Det tredje underlaget är beteendet på serversidan. Om er backendtjänst tolkar, filtrerar eller lagrar det som enheten skickar måste detta beteende finnas och vara testbart innan enheten tilldelas riktiga data. Om det ännu inte finns hör det till den kritiska vägen och till er sida av programmet, inte till leverantörens. Det är värt att ta upp i god tid eftersom det är den vanligaste orsaken till att en provenhet kan parkopplas men inte visa hela flödet.

Det fjärde underlaget är beslutsunderlaget för appsidan. Levererar varumärket en egen mobilapplikation eller konfigurerar den applikation som tillhandahålls av fabriken? Vilka skärmar finns och vad står det på var och en? Vilka reglage visas på själva enheten och vilka finns endast i applikationen? Vad händer vid första parkoppling, vid firmwareuppdatering och vid återställning till fabriksinställningar? Vem skriver texterna på de språk som stöds?

Den femte inputen är distributions- och uppdateringsmodellen. Vilken butik eller kanal går appen igenom, hur ser gransknings- och publiceringsflödet ut, och kan fabrikena firmwareuppdateringar eller kan varumärket det? En produkt som är beroende av en mobilapp för en kärnfunktion har en annan riskprofil om appen finns i varumärkets egen butikskonto än om den är beroende av en enda fabriksbyggd version.

Den femte inputen har en subtilitet som är värd att benämna. Vem som innehar signeringsnyckeln avgör vem som kan släppa en fix när ett fel uppstår i fält. Om nyckeln finns hos varumärket styr varumärket tidpunkten men bär den operativa bördan av varje uppdateringscykel. Om fabriken innehar den styr fabriken fixen, men varumärket har mindre insikt i när den lanseras. Inget av alternativen är fel, men det måste vara ett namngivet beslut och det bör finnas i avtalet, inte i en e-posttråd. Samma fråga gäller backenduppgifterna, butikskontot och testkontona – fråga om fabriken behöver produktionsuppgifter alls och föredra en testmiljö med separata uppgifter när plattformen tillåter det.

Den sjätte inputen är evidenspaketet: vilka beteenden som ska demonstreras, i vilken ordning, av vem och på vilket sätt de ska dokumenteras. Det är ämnet för nästa avsnitt.

Det finns en praktisk ordning för allt detta som erfarna programinköpare följer utan att få instruktioner. Kraven skrivs först ner i köparens eget språk, översätts sedan till testbara formuleringar och lämnas först därefter över. Ett krav formulerat som "appen ska kännas premium" går inte att testa; samma krav formulerat som "appen visar glasögonens batterinivå inom två sekunder efter anslutning" går att testa och kan verifieras på produktionsexemplaret. Vi driver den omskrivningen under kravsteget eftersom varje timme som läggs på att precisera formuleringen är billigare än en provcykel som kommer tillbaka med en tvist.

En överlämningspunkt som sparar besvärligheter senare: versionssätt inmatningsdokumenten själva. Lås gränssnittsdocumentet, textunderlaget och skärmlistan under ett revisionsnummer och dokumentera vilken revision firmwarebygget baserades på. Integrationsprojekt tenderar att ackumulera små textändringar och små ändringar av ändpunkter, och utan en revisionsmarkering kan ingen senare avgöra om en beteendeskillnad är en regression eller en avsedd ändring. En kort ändringslogg bifogad kravdokumentet räcker.

Vi behandlar dessa inputar som ett enda frysningsstillfälle. När de alla finns tillgängliga blir de en del av det frysta kravdokumentet tillsammans med hårdvarukonfigurationen, förpackningen och de tillåtna påståendena, och firmwarebygget som tas fram i steget för utveckling och verktyg matchas mot det dokumentet i stället för mot en serie verbala instruktioner. Köpare som vill ha en referens för den typ av funktionsomfattning som ligger bakom dessa förfrågningar kan se AI-funktionsöversikten på /tech/ai-features, men acceptansmetoden är viktigare än funktionslistan.

Sekvens av köparens inputar innan firmwarebygget och apparbetet börjar

AI-genererat fotografi som illustrerar teknisk anpassning: frågor om appintegration – bild 2 av 3

Hur appändringen verifieras vid provgrinden

Verifieringen vid grinden för byggda och verifierade prover är där apparbetet antingen håller eller misslyckas i smyg. Grinden producerar två resultat: ett signerat guldprov och en verifieringsrapport. Guldprovet är den enda enhet som representerar den godkända produkten; verifieringsrapporten är evidensen för att provet beter sig enligt det frysta kravet.

För app- och firmwaresidan måste verifieringsrapporten täcka parkoppling, ljud, laddning, eventuella kamerafunktioner och kontrollbeteenden. För en specifik integration ska följande kontroller ingå i den och läsas rad för rad innan ett guldprov signeras.

  1. Parkopplingsbeteende: enheten visar det namn som anges i kravet, parkopplas med den angivna appen på en angiven version av operativsystemet och parkopplingsupplevelsen matchar det beskrivna flödet, inklusive vägen för om parkoppling efter en återställning.
  2. Kartläggning mellan app och enhet: varje kontroll som exponeras i appen ger det dokumenterade enhetsbeteendet, och varje kontroll på enhetssidan ger det dokumenterade appläget, utan odokumenterade sidoeffekter.
  3. Nätverksbeteende: enheten ansluter till den angivna ändpunkten, skickar den angivna nyttolasten, hanterar det angivna felmeddelandet och visar det angivna beteendet när tjänsten inte är tillgänglig.
  4. Uppdatering och återställning: den dokumenterade uppgraderingsvägen slutförs, och den dokumenterade vägen för återställning eller återhämtning återställer det överenskomna tillståndet.
  5. Språk- och etikettinnehåll: varje användarvis textsträng matchar den frysta texten för varje språk som stöds.

Varje kontroll bör kunna upprepas av en person som inte var närvarande under utvecklingen, med hjälp av guldprovet och en skriven procedur. Det är hela syftet med guldprovet: det eliminerar behovet av att minnas vad ingenjören såg under integrationen.

Två praktiska varningar. För det första ska golden sample signeras mot en specifik identifierare för en firmwarebyggning, inte mot ”den senaste byggningen”. Firmwareversioner förändras, och en golden sample som endast är meningsfull i tillverkarens huvud är inte en referens. För det andra ska verifieringen göras på den hårdvarukonfiguration som faktiskt ska levereras. En integration som är bevisad på en utvecklingskort ger dig mycket lite information om en produktionsenhet, eftersom ljudvägen, radiobeteendet och effektbudgeten alla påverkas av hårdvaran.

De typiska felmönstren vid denna kontroll är tillräckligt konsekventa för att benämna, eftersom varje fel har en billig förebyggande lösning. Det vanligaste är en verifiering som endast bevisar det lyckade förloppet: parkopplingen fungerar en gång, i ett nätverk, med en telefonmodell, och dokumentationen anger att ”parkopplingen är verifierad”. Det andra är en avvikelse i materialet, där det frysta innehållet skrevs på köparens språk medan firmware levererades med standardtexter på vissa skärmar. Det tredje är en skillnad i backend mellan test- och produktionsmiljöerna, så att enheten fungerar korrekt mot en mock men misslyckas mot den verkliga tjänsten. Det fjärde är ett gap i uppdateringsvägen, där den ursprungliga byggningen fungerar men den dokumenterade uppgraderingsvägen aldrig har testats på en riktig enhet.

Allt detta förebyggs med en skriven procedur, inte med en bättre ingenjör. Begär verifieringsdokumentationen innan golden sample signeras, inte efteråt, och fråga om varje kontroll har utförts på hårdvara som representerar produktionen och mot en namngiven miljö. Vi kommer att presentera verifieringsdokumentationen för granskning innan golden sample signeras, eftersom en kontroll som inte kan misslyckas inte är en kontroll, och ett osignerat dokument inte är ett bevis. Om svaret är att en kontroll har utförts en gång informellt är kontrollen ännu inte ett bevis, och det är mycket billigare att få veta detta vid kontrollen av golden sample än under pilotkörningen. Om köparen vill ha oberoende säkerhet är en överenskommen tredjepartsinspektion vid kontrollen en legitim kommersiell lösning som kan prissättas i offerten.

Behandla även golden sample som en fysisk tillgång med en definierad livscykel. Var förvaras den, vem får hantera den, slits den ut genom användning och vad händer med den när projektet avslutas? En golden sample som tappas, plockas isär eller lånas ut till en kund förlorar sin betydelse, och projektet börjar i tysthet jämföra produktionsenheter med ett minne i stället för med en referens. Behåll en signerad enhet, se till att den är identifierad och förvara verifieringsdokumentationen intill den.

Om appen distribueras via en appbutik ingår butiksversionen i verifieringspaketet och har en egen granskningsprocess, så planera för den i förväg i stället för att upptäcka den senare. Likaså bör allt beteende som är beroende av backend tas med i verifieringsdokumentationen när backend är i sitt testtillstånd, eftersom ett godkänt test mot en aktiv produktionsendpoint berättar något om endpointen, inte om firmwareen.

Verifieringsmatris som kartlägger integreringskontroller över enheter och backendar

När kontrollen av golden sample är avslutad måste appens och firmwareens konfiguration överföras oförändrad till överensstämmelsedokumentationen och till pilotkörningen. En pilotkörning med produktionsverktyg i produktionsvolym, granskad mot golden sample, är det som bevisar att appens beteende är repeterbart i en tillverkningsmiljö och inte bara i integrationslaboratoriet. Om pilotenheterna beter sig annorlunda än golden sample vad gäller appen var golden sample inte rätt referens och kraven var inte tillräckligt tydligt frysta.

AI-genererat fotografi som illustrerar teknisk anpassning: frågor om appintegration – bild 3 av 3

Frågor att ställa om omfattningen av en appintegration

Använd dessa som utgångspunkt i en leverantörsfrågeformulär. De är formulerade så att svaret måste vara specifikt, inte så att det låter välvilligt.

  1. Vilka delar av vår begäran om appintegration är konfigurationsändringar av en befintlig firmwarebygge, och vilka kräver nytt ingenjörsarbete? Vänligen besvara per funktion, inte per projekt.
  2. Vad behöver ni av oss innan firmwarebygget påbörjas: konton, inloggningsuppgifter, dokumentation för endpoint, testbackend, texter eller distributionsupplägg?
  3. Vilket serverbeteende måste finnas i vårt system innan ni kan verifiera enheten från början till slut, och vem i vår organisation ansvarar för det arbetet?
  4. Vad verifierar guldprovet för det här projektet exakt på appsidan, och hur spelas det in så att en tredje part kan upprepa det?
  5. Vilken identifierare för firmwarebygget kommer guldprovet att signeras mot, och hur förhindrar ni att guldprovet och senare produktionsenheter avviker från varandra?
  6. Om appen distribueras via en butik, vilket steg i vår verifieringsplan beror på butiksgranskningen, och vad händer med programtidsplanen om den granskningen försenas?
  7. Om projektet stoppas efter att verktygen är klara, vad händer då med verktygskostnaden, och vad äger eller får vi då?
  8. Vilket underlag kommer pilotkörningen att ge för att appbeteendet stämmer överens med guldprovet, och vid vilken kvantitet kommer pilotkörningen att genomföras?
  9. Vilka av de marknadsförsökningar vi vill göra om appupplevelsen kräver underlag utöver verifieringsdokumentationen, och ingår dessa påståenden i försäkran om överensstämmelse för modellidentifieringen som ska levereras?
  10. Vad är garantipositionen för applikationen och firmware, med tanke på att ett fel i vår backend uppfattas som ett enhetsfel av slutanvändaren?

Fråga 7 förtjänar särskild uppmärksamhet. Verktygsframställningen är det minst reversibla steget i hela programmet, och det skriftliga avtalet om verktygskostnaden om projektet stoppas bör undertecknas innan verktygsarbetet åtar sig, inte efteråt. Fråga 9 är där många antaganden från köparens sida möter en tydlig regel om överensstämmelse: en försäkran om överensstämmelse omfattar exakt den modellidentifiering som ska levereras och de underliggande rapporterna. Ett påstående om appbeteende som inte täcks av det underlaget bör inte förekomma på förpackningen.

En till fråga som också förtjänar plats i listan: vad är inte publicerat och därför måste frågas om i stället för att antas. I vår katalog publicerar vi vad produkten är och vad den publicerade specifikationen innehåller, medan vi håller opublicerade uppgifter opublicerade, bland annat produktionskapacitet, tidsåtgång per fas, priser, minsta beställningskvantitet och certifieringsstatus per modell. Fråga därför leverantören direkt om de kommersiella villkoren bakom offerten, ledtiden för verktygsframställningen och pilotbeställningen samt certifieringsunderlaget för den modellidentifiering som ska levereras. Rätt svar är ett dokument, inte ett löfte.

När ni använder de här frågorna bör ni använda dem för att jämföra, inte för att förhörja. Listan nedan är de frågor som bör ställas till leverantören inom området appintegration, och den är värd att läsa tillsammans med den kommersiella ramen: offertens grund, MOQ, ledtid, Incoterms, förpackning och reservdelar, garanti samt pilotbeställningen. Varje enskild punkt är något ni bör fråga leverantören om, i stället för en siffra som hämtats från ett tidigare program, och vi kommer att besvara dem med de dokument som finns, inte med uppgifter som vi inte publicerar.

En leverantör som besvarar varje fråga med ett dokument, även ett kort, visar hur programmet kommer att genomföras. En leverantör som avböjer de kommersiella frågorna har också berättat något användbart, även om svaret inte är det ni önskade. Vid förhandling är den värdefulla positionen oftast den där kravspecifikationen, verifieringsdokumentationen och överensstämmelsefilen redan är skrivna, eftersom de dokumenten begränsar kostnaderna mycket mer effektivt än ett e-postmeddelande med en specifikation någonsin har gjort. Köparen som kommer med en fastställd kravspecifikation kan förhandla om pris, Incoterms, reservdelar och garanti; köparen som kommer med en önskelista kan bara förhandla om priset för att ta reda på vad önskelistan innebar.

Det är också därför som apparbetet hör hemma i samma sexstegssekvens som allt annat. Ett firmwarebygge som matchar en fastställd kravspecifikation är reproducerbart. Ett firmwarebygge som matchar ett samtal är det inte, och inget bra relationshantering kan reparera det när slutkunden rapporterar ett fel. Skriv kravspecifikationen, fastställ den, bygg mot den, verifiera den med ett signerat guldprov, för den in i överensstämmelsefilen för den modellidentifiering som ska levereras och bevisa den igen på produktionsverktygen under pilotkörningen.

För att gå djupare på den kommersiella och programspecifika sidan beskriver översikten över anpassningsalternativ på /blog/customization-options-overview de olika programformerna, medan /blog/customization-options-lead-time-impact förklarar varför formen på en beställning påverkar ordningen på arbetet och inte antalet veckor. Rambruket för teknisk anpassning på /oem-odm/engineering-customization fortsätter att vara referensen för hur de sex kontrollpunkterna hänger ihop.

Kort sagt: en begäran om appintegration är ett krav, inte ett önskemål. Klassificera den som konfiguration eller utveckling, lämna över de uppgifter som fabriken inte kan hitta på, lås den skriftligt, verifiera den mot ett signerat referensexempel på den hårdvara som ska skickas, och för den oförändrad genom hela dokumentationen för överensstämmelse och pilotkörningen. Det är den ordningen som skiljer en integration som kan växa från en integration som fortsätter att överraska.

Chatta på WhatsApp
Din upplevelse på denna webbplats kommer att förbättras genom att tillåta cookies.