Companion pentru Windows

Instalează și actualizează aplicația iOS creată în OpenV2 pe un iPhone, de pe Windows, cu Companion și USB.

OpenV2 Companion conectează PC-ul cu Windows la iPhone pentru a instala și testa aplicația iOS nativă pe care o construiești în OpenV2. Nu ai nevoie de propriul Mac pentru acest flux.

OpenV2 pregătește build-ul pentru dispozitiv. Companion îl semnează pe PC cu contul tău Apple, îl instalează prin USB și încearcă să îl lanseze pe iPhone.

Înainte de a începe

Un PC cu Windows și procesor pe 64 de biți, cu acces la internet.
Un cont OpenV2 Pro sau Max și un proiect iOS nativ. Companion se descarcă gratuit; build-urile native necesită un plan OpenV2 plătit.
Un cont Apple la care te poți conecta și pentru care poți finaliza verificarea când este cerută. Un cont Apple gratuit poate fi folosit pentru testare personală pe dispozitiv, în limitele de semnare Apple.
Un iPhone deblocat și un cablu USB care transferă date, nu doar încarcă.
Apple Devices pe Windows dacă iPhone-ul nu este detectat. Verifică dacă Apple Devices vede telefonul înainte de a reîncerca în Companion. Vezi depanarea conexiunii oferită de Apple.

1. Descarcă și deschide Companion

Descarcă OpenV2 Companion pentru Windows sau selectează Get OpenV2 Companion în meniul de dispozitive al proiectului.
Dacă primești un ZIP, extrage întreaga arhivă într-un folder de pe PC și deschide OpenV2 Companion.exe din acel folder. Păstrează fișierele auxiliare lângă aplicație. Dacă primești un executabil de instalare, urmează pașii acestuia și deschide Companion.
Lasă Companion pornit cât timp configurezi telefonul și instalezi build-uri. Închiderea ferestrei îl lasă în zona de notificări Windows; Quit din meniul pictogramei îl oprește.
Revino la OpenV2 în browser. Dacă browserul cere permisiunea de a se conecta la aplicații de pe calculator, permite accesul pentru OpenV2 ca să poată detecta Companion.

Linkul de descărcare trimite la pachetul Windows configurat în prezent. Folosește din nou acel link când actualizezi Companion.

2. Conectează conturile

În Companion, selectează rândul OpenV2. Finalizează autentificarea și autorizarea în browser, apoi revino la Companion. Rândul trebuie să afișeze adresa de e-mail a contului OpenV2. Folosește același cont care deține sau poate accesa proiectul.

Selectează rândul Apple și introdu datele contului Apple în Companion. Dacă ți se cere, introdu codul de verificare din șase cifre de pe dispozitivul Apple de încredere sau prin metoda de verificare afișată. Așteaptă până când rândul Apple afișează contul tău.

Autentificarea Apple și semnarea pentru dispozitiv rulează local pe PC. Introdu parola Apple în formularul de autentificare Companion, nu în chatul proiectului OpenV2 sau în secretele V2 Cloud.

3. Conectează și pregătește iPhone-ul

Conectează iPhone-ul la PC cu cablul USB de date și deblochează-l.
Pe iPhone, acceptă Trust This Computer și introdu codul telefonului dacă este cerut. Rândul iPhone din Companion trebuie să afișeze dispozitivul.
Pe iPhone, deschide Settings → Privacy & Security → Developer Mode. Activează opțiunea, repornește dacă ți se cere și confirmă activarea după repornire. Apple descrie acest pas în activarea Developer Mode.
Reconectează și deblochează telefonul după repornire. Verifică rândul Developer Mode din Companion și urmează instrucțiunile rămase.

În cazul în care Developer Mode lipsește, selectează rândul Developer Mode din Companion și urmează mesajul afișat, apoi verifică din nou setările telefonului. Companion poate pregăti suportul de dezvoltare al dispozitivului; confirmarea Developer Mode se face în continuare pe iPhone.

Trust This Computer autorizează conexiunea USB. Pasul de acordare a încrederii dezvoltatorului, descris mai jos, autorizează aplicația instalată. Finalizează ambele când sunt cerute.

4. Instalează din proiectul OpenV2

Deschide proiectul iOS salvat în OpenV2 și selectează iPhone-ul conectat din comenzile pentru dispozitive.
Deschide meniul dispozitivului și selectează Install on [numele iPhone-ului] sau folosește Play cu telefonul selectat.
Păstrează telefonul conectat și deblocat cât timp OpenV2 construiește aplicația, iar Companion o descarcă, semnează și instalează. Urmărește progresul instalării; un preview reușit în simulator nu instalează singur aplicația pe telefon.
După instalare, dacă iOS cere acordarea încrederii dezvoltatorului, deschide Settings → General → VPN & Device Management, selectează intrarea dezvoltatorului pentru contul tău Apple și urmează solicitările de acordare a încrederii.
Deschide aplicația de pe ecranul principal al iPhone-ului dacă nu a pornit automat. Verifică ecranul și funcțiile dispozitivului pe care vrei să le testezi.

Installed înseamnă că aplicația a fost transferată pe telefon. Running confirmă și că încercarea de lansare făcută de Companion a reușit. O aplicație instalată poate necesita încă acordarea încrederii înainte de a o putea deschide.

Actualizează și reînnoiește un build de test

Salvează modificările în OpenV2 și instalează din nou pentru a testa ultima revizie. Reinstalarea aceluiași proiect actualizează aplicația existentă. Cu telefonul selectat și Companion pornit, fluxurile de editare care suportă acest comportament pot reinstala automat; folosește Install sau Play dacă telefonul afișează încă o versiune veche.

După instalare și acordarea încrederii, când este necesară, poți deconecta USB și deschide aplicația pe telefon. Funcțiile care folosesc V2 Cloud sau alte servicii online necesită în continuare acces la internet.

Profilurile de semnare Apple Personal Team gratuite expiră la șapte zile de la emitere, așa că poate fi necesar să reconectezi telefonul și să reconstruiești, semnezi și instalezi aplicația. Vezi limitele contului de dezvoltator Apple. Companion nu oferă reînnoire programată în fundal cât timp telefonul este deconectat.

Dacă iOS raportează limita de trei aplicații pentru un profil de dezvoltator gratuit, șterge de pe telefon o aplicație de test pe care o alegi înainte de reîncercare. Ștergerea unei aplicații poate șterge și datele sale locale. Reinstalarea aceluiași proiect înlocuiește în mod normal aplicația existentă.

Depanare

Ce vezi	Ce trebuie să faci
Companion nu este detectat	Deschide-l din folderul extras sau din scurtătura instalată, permite conexiunea locală cerută de browser și reîncearcă meniul dispozitivului. Dacă Open nu îl lansează, pornește-l manual.
iPhone-ul doar se încarcă sau lipsește	Încearcă un cablu de date și alt port USB, deblochează telefonul, acceptă încrederea în calculator și confirmă detectarea în Apple Devices.
Developer Mode este incomplet	Activează-l pe iPhone, finalizează confirmarea după repornire și reconectează USB. Urmează instrucțiunile rândului din Companion dacă opțiunea lipsește.
Verificarea sau autentificarea Apple eșuează	Folosește codul de verificare curent, verifică datele contului și finalizează solicitările contului Apple înainte de a reîncerca în Companion.
Sesiunea OpenV2 a expirat	Selectează rândul OpenV2 din Companion și autorizează din nou cu contul din browser care are acces la proiect.
Build-ul sau semnarea a eșuat	Citește eroarea raportată. Repară erorile de build în proiect; rezolvă erorile contului Apple sau de semnare în Companion și reîncearcă. O semnare eșuată nu instalează o aplicație nesemnată.
Limita de aplicații a contului gratuit este atinsă	Șterge de pe iPhone o aplicație de test aleasă de tine și reîncearcă. Setările de încredere nu eliberează un loc pentru aplicații.
Aplicația instalată nu se deschide	Finalizează încrederea în dezvoltator și Developer Mode, păstrează telefonul online pentru verificare și reinstalează dacă profilul de test a expirat.
Instalarea durează prea mult	Verifică solicitările din Companion și de pe telefon. Păstrează USB conectat, așteaptă finalizarea jobului curent și reîncearcă dacă a eșuat.

Pentru ajutor, contactează [email protected] cu pasul care a eșuat și mesajul de eroare. Nu include parole, coduri de verificare sau tokenuri de cont în capturile trimise la suport.

Publică aplicația

Fluxul USB din Companion este pentru testarea propriului proiect nativ pe un telefon conectat. Nu trimite aplicația în App Store și nu o distribuie prin TestFlight. Vezi Build-uri native pentru fluxul separat de publicare și cerințele Apple Developer.