Instalace nástrojů k vytváření aplikací pro iOS

Tento článek odkazuje na Visual Studio Tools for Apache Cordova, což je předběžná verze softwaru. Popisované funkce jsou ve verzi Preview a můžou se změnit. Verzi Preview si můžete stáhnout z webu Microsoft Download Center.

K vytvoření a spuštění aplikace pro iOS v systému iOS simulátor nebo v zařízení se systémem iOS pomocí sady Visual Studio, musíte nainstalovat a nakonfigurovat vzdáleného agenta vs mda vzdáleného, v počítači Mac, který splňuje požadavky uvedené níže.(V současné době aplikace pro iOS nemůže být vytvořen v systému Windows.) V sadě Visual Studio ve vašem počítači je nutné také nakonfigurovat vzdáleného agenta, jak je popsáno v tomto tématu.

[!POZNÁMKA]

Pokud používáte systém Windows na Mac pomocí virtualizačních technologiích, můžete vytvořit a spustit iOS místně.Další informace naleznete v tématu Vytváření aplikace Cordova pro iOS za použití Parallels.Informace o používání služeb Mac hostovaný v cloudu místo Mac naleznete v tématu Vytváření a simulace iOS v cloudu.

Před instalací vzdáleného agenta, přesvědčte se, zda máte nainstalována sada Visual Studio Tools pro Apache Cordova.

Instalace a konfigurace vzdáleného agenta pro vytváření a simulaci iOS

Můžete nakonfigurovat agenta ke zpracování požadavků sestavení a spusťte aplikaci v zařízení se systémem iOS nebo iOS simulátor.K hostování vzdáleného agenta, musí mít v počítači Mac nainstalovat následující:

• Mac OS X Mavericks

• Xcode 6

• Nástroje příkazového řádku Xcode (z Terminálové aplikace, použijte xcode-select --install)

• Node.js

Je také nutné mít následující:

• Aktivní systému iOS Developer Program účtu s Apple

• IOS zřizování profil nakonfigurován v Xcode (stažení zřizování profilu a spusťte soubor stažené *.cer)

  [!POZNÁMKA]

  Podrobné informace najdete Údržba a aktualizace identit svůj podpis a certifikáty v systému iOS Developer knihovny.

• Podepisování identity nakonfigurovaná v Xcode (zvolte XCode, Předvolby)

Ke stažení a instalaci vzdáleného agenta

• Z Terminálové aplikace v počítači Mac zadejte:

  sudo npm install -g vs-mda-remote --user=$USER
  

  kde $USER budou nahrazeny své uživatelské jméno na Mac.Při spuštění příkazu se výzva k zadání hesla také.

  Globální instalace (-g) přepínače je doporučeno, ale není nutné.

  Během instalace budou nainstalovány vs mda vzdáleného a režimu Vývojář bude aktivován v vašeho systému Mac.Homebrew a dva balíčky npm budou také nainstalovány.

  Upozornění
  Chcete-li nainstalovat Homebrew, je nutné použít sudo (správce).Pokud potřebujete k instalaci mda vzdáleného vs bez příkazu "sudo", můžete ručně nainstalovat Homebrew do umístění usr/local a její složka Koš přidejte si do cesty.Další informace naleznete Homebrew dokumentace.If you need to manually enable developer mode, type the following in the Terminal app: DevToolsSecurity –enable

Pokud jste aktualizovali počítače na novou verzi sady Visual Studio, je nutné aktualizovat pro aktuální verzi vzdáleného agenta.

Chcete-li aktualizovat vzdáleného agenta

• Opakováním kroku instalace z předchozího oddílu.

Chcete-li spustit vzdáleného agenta

• Z Terminálové aplikace v počítači Mac zadejte:

  vs-mda-remote
  

  Tímto spustíte agenta s výchozí adresář sestavení ~ / vzdálený sestavení.Možnosti dodatečnou konfiguraci pro agenta jsou popsány dále v tomto tématu.

  Při prvním spuštění agenta, bude poskytována s informace potřebné k konfigurace agenta v sadě Visual Studio, včetně hostitele, port a bezpečnostní kód PIN.

  

  Důležité
  V této verzi bylo nové navrženo vs mda vzdáleného pro zabezpečený přenos sestavení datových částí, chcete-li a ze sady Visual Studio pomocí kódu PIN.

• Pokud máte v úmyslu ke konfiguraci vzdáleného agenta v sadě Visual Studio pomocí názvu hostitele, zadejte příkaz ping Mac pomocí názvu hostitele k ověření, že je dostupný.Jinak je třeba místo toho použijte adresu IP.

Před použitím vzdáleného agenta, je nutné zadat konfiguraci vzdáleného v sadě Visual Studio.

Konfigurace vzdáleného agenta ze sady Visual Studio

1. Pokud ještě není spuštěn agent v počítači Mac, spusťte vzdáleného agenta.

2. V počítači Mac se získáte název hostitele nebo IP adresa vašeho systému Mac.

   Můžete získat adresu IP pomocí ifconfig příkazu.

3. V nabídce sady Visual Studio, zvolte nástroje, možnosti.

4. V možnosti otevřete dialogové okno nástroje pro Apache Cordovaa poté zvolte možnost konfiguraci vzdáleného agenta.

5. Nastavit povolit vzdálená iOS zpracování k True.

6. V hostitele, Port, a PIN kód zabezpečení pole, zadejte hodnot určených vzdáleným agentem při spuštění při prvním.Hostitel může být název nebo adresu IP vašeho systému Mac.Výchozí port je 3000.

   

   [!POZNÁMKA]

   Pokud nelze pomocí příkazu ping Mac pomocí názvu hostitele, můžete použít IP adresu.

   Když kliknete na tlačítko OK, Visual Studio připojí k vzdáleného agenta (agenta musí být spuštěna pro připojení).

   Pokud chcete zakázat režim zabezpečení a povolit jednoduché připojení založené na protokolu HTTP, zadejte následující příkaz v aplikaci Terminálové:

   vs-mda-remote --secure false
   

   Poté můžete nechat PIN kód zabezpečení prázdné pole při konfiguraci agenta v sadě Visual Studio.

Zastavit agenta

• Z Terminálové aplikace v počítači Mac stiskněte kombinaci kláves Ctrl + C.

Při prvním spuštění agenta vygenerovaný PIN kód je platný pro omezené množství času (ve výchozím nastavení je 10 minut).Pokud nechcete připojit k agentovi, před vypršení časového limitu, je nutné vytvořit nový kód PIN.

Chcete-li generovat nový bezpečnostní kód PIN

1. Zastavit agenta (nebo otevřete druhé okno terminálové aplikace v počítači Mac a které slouží k zadání příkazu).

2. Z Terminálové aplikace v počítači Mac zadejte:

   vs-mda-remote generateClientCert
   

Z bezpečnostních důvodů certifikáty serveru tuto dvojici sady Visual Studio se vzdáleným agentem jsou svázány s počítači Mac IP nebo název hostitele.Pokud tyto hodnoty změnili, je nutné vygenerovat nový certifikát serveru a potom znovu nakonfigurovat sadu Visual Studio s nové hodnoty.

Vygenerovat nový certifikát serveru

1. Zastavte agenta.

2. Z Terminálové aplikace v počítači Mac zadejte:

   vs-mda-remote resetServerCert
   

3. Po zobrazení výzvy, zadejte "Y" a poté zadejte Enter.

4. Z Terminálové aplikace v počítači Mac zadejte:

   vs-mda-remote generateClientCert
   

5. Postupujte podle pokynů výše a zadejte v zabezpečení nové informace o kódu PIN a IP adresy nebo hostitele.

Můžete nakonfigurovat vzdáleného agenta pomocí různé možnosti příkazového řádku.Můžete například zadat port naslouchat požadavkům sestavení a zadejte maximální počet sestavení udržovat v systému souborů.(Ve výchozím nastavení je limit je 10.Agent dojde k odebrání sestavení, které překračuje maximální na vypnutí.)

Upozornění
Některé z těchto možností se od verze 0.2 vs mda vzdálené změnily.Nejdůležitější změna je, že možnost--buildDir byla přejmenována na--serverDir.

Konfigurace vzdáleného agenta

• Chcete-li zobrazit úplný seznam příkazů agenta, zadejte:

  vs-mda-remote --help
  

• Chcete-li režim zabezpečení zakázat a povolit jednoduché připojení HTTP na základě, zadejte:

  vs-mda-remote --secure false
  

  Použijete-li tuto možnost, ponechejte pole Kód PIN prázdné při konfiguraci agenta v sadě Visual Studio.

• Chcete-li určit umístění pro soubory vzdáleného agenta, zadejte:

  vs-mda-remote --serverDir <directory>
  

  kde < adresář > je v počítači Mac na místo, kde budou umístěny soubory protokolů, sestavení a certifikátů serveru.Umístění může být například /Users/uživatelské jméno/sestavení.(Sestavení bude uspořádané podle číslo sestavení v tomto umístění.)

• Chcete-li použít zpracování na pozadí tak, aby zachytával stdout a stderr do souboru (server.log), zadejte:

  vs-mda-remote > server.log 2>&1 &
  

  Soubor server.log mohou pomoci při řešení potíží s problémy se sestavením.

• Chcete-li spustit agenta pomocí konfiguračního souboru namísto parametry příkazového řádku, zadejte:

  vs-mda-remote --config <path-to-config-file>
  

  Konfigurační soubor musí být ve formátu JSON.Možnosti spuštění a jejich hodnoty nesmí obsahovat pomlčky.Chcete-li zobrazit příkladem konfiguračního souboru, podívejte se na složku vs-mda-remote/examples/exampleConfig.json v instalačním adresáři vzdáleného agenta.Cesta může být například /usr/local/lib/node_modules/vs-mda-remote/examples/exampleConfig.json.

Chcete-li ověřit konfiguraci vzdáleného agenta

• Se vzdáleným agentem spuštěna, otevřete druhé okno terminálové aplikace (zvolte prostředí, nové okno).

• Z druhého okna Terminálové aplikace v počítači Mac zadejte:

  vs-mda-remote test
  

  Důležité
  Tento příkaz se nezdaří, pokud agent není spuštěn v druhém okně.

  Tento příkaz spustí testovací sestavení.Výstup z příkaz, který by se zobrazit číslo sestavení a další informace o sestavení, jako například jeho průběh.

  Po spuštění testu sestavování, ověřte sestavení.

• Pokud jste začali serveru na jiný port než 3000, použijte následující příkaz zahájit test sestavení:

  vs-mda-remote test https://localhost:<portNumber>
  

• Chcete-li ověřit, že vaše vývojářské k podepisování identity je správně nastavit pro zařízení sestavení (pomocí konfigurace Debug a Release v sadě Visual Studio), zadejte:

  vs-mda-remote test --device
  

• Chcete-li ověřit, zda sestavení vaší distribuce k podepisování identity je správně nastavit pro zařízení (pomocí konfigurace distribuce v sadě Visual Studio), zadejte:

  vs-mda-remote test --device --cfg distribution
  

  Další informace o zřizování aplikace a identit podepsání certifikátu, naleznete v části Zabalení aplikace vytvořené s nástroji Visual Studio Tools for Apache Cordova.

V některých případech je třeba získat přístup k generovaného projektu Xcode nativní potíží.Naštěstí můžete rychle získat přístup k projektu, který slouží k vytvoření aplikace.

Pro přístup k generovaného projektu Xcode

1. Vytvoření aplikace pomocí systémem iOS simulátor nebo cílového zařízení.

2. Po dokončení sestavení přejít do okna výstupu a vyberte možnost zobrazit výstup z: sestavení.

   Poslední položky výstupu sestavení by mělo vypadat podobně jako následující:

   1>  ** BUILD SUCCEEDED **
   1>  
   1>  Command finished with error code 0: /Users/<username>/remote-builds/builds/8382/cordovaApp/platforms/ios/cordova/build --debug
   

3. V počítači Mac přejděte ke složce systému ios v cestě uvedené ve výstupu sestavení.V předchozím příkladu je to /Users/ < uživatelské_jméno > / vzdálený sestavení/sestavení/8382/cordovaApp/platformy/ios

   Důležité
   Při zastavení vs mda vzdáleného agenta sestavení (včetně generovaného xcode projektu) bude odstraněn, avšak zahájeno mda vzdáleného vs pomocí následujícího příkazu: --deleteBuildsOnShutdown false.

4. Dvojitým kliknutím na soubor .xcodeproj v této složce a projekt, který se otevře v Xcode.

Viz také

Koncepty

Instalace nástrojů Visual Studio Tools for Apache Cordova

Spuštění aplikace Apache Cordova v iOS