Debuger

Debuguj projekt za pomocą Visual Studio Debugger (LLDB), gdy korzystasz z Rozszerzenie Android Game Development.

Uruchamianie debugera

Zanim uruchomisz debuger, musisz być w stanie skompilować, wdrożyć i uruchomić gry na Androida. Więcej informacji znajdziesz w sekcji Uruchamianie przykładu.

Gdy upewnisz się, że grę można uruchomić bez debugera, za pomocą parametru debugera, naciskając F5 lub wybierając element Rozpocznij debugowanie. w menu Debuguj. Podczas podłączania debugera powinno się pojawić okno do gry.

Uruchomienie debugera może potrwać od 10 sekund do 1 minuty w zależności od rozmiaru aplikacji i liczby potrzebnych symboli ładowany podczas uruchamiania. Podłączenie do nowego urządzenia trwa dłużej przez ponieważ debuger musi pobrać niektóre biblioteki Androida z z komputerem hosta. Jeśli podczas pierwszego na nowym urządzeniu, rozważ anulowanie sesji debugowania, a następnie i uruchomię go z powrotem.

Po uruchomieniu debugera w ten sposób gra uruchamia się w trybie Czekam na w trybie debugera. Nie będzie on wykonywać kodu gry do czasu nawiązywane jest połączenie z debugerem. Pozwala to również debugować sekcję inicjowania funkcji Twojej gry.

Więcej informacji o konkretnych funkcjach debugera Visual Studio znajdziesz w tych sekcjach: znajdziesz w dokumentacji Studio Visual Studio.

Dołączanie do procesu

jeśli chcesz debugować grę, która jest już uruchomiona w trybie fizycznym lub wirtualnym; urządzenia, możesz podłączyć debuger do procesu z poziomu Visual Studio.

W Visual Studio upewnij się, że rozwiązanie na Androida jest otwarte, a następnie:

1. Otwórz menu Debugowanie i wybierz Attach to Process (Dołącz do procesu).
2. W menu Transport wybierz Android Game Development Extension (Rozszerzenie do tworzenia gier na Androida).
3. Z menu Kwalifikator wybierz swoje urządzenie z Androidem.
4. Wybierz proces gry z listy dostępnych procesów kliknij Dołącz.

Wykonywanie poleceń LLDB.Shell

Gdy sesja debugowania jest aktywna, uruchom polecenie w oknie poleceń Visual Studio Polecenia LLDB.Powłoka.

Format polecenia:

LLDB.Shell [command]

Przykład:

>LLDB.Shell expr myIntVariable = 9
Status:  Success
Output Message:
(int) $2 = 9

Wizualizacja danych

Specyfikatory formatu

Możesz zmienić format wyświetlania wartości w sekcji Auto, Okna Locals, Watch i zmiennych DataTip, korzystając ze specyfikacji formatu.

Specyfikacje formatu znajdują się na końcu wyrażeń. Zaczynają się od przecinka, a po nim krótki ciąg znaków. Na przykład specyfikator ,x w parametrze _myInt,x wyrażenie będzie formatować myInt jako małe litery szesnastkowe.

Specyfikacji formatu można użyć bezpośrednio w oknie Obejrzyj lub Autos, Locals i DataTip, dodając je do Natvis wyrażeń. Więcej informacji znajdziesz na stronie Natvis.

Lista specyfikacji pomocy

Natvis

Platforma Natvis umożliwia dostosowanie sposobu wyświetlania zawartości do Visual Studio. natywne w oknach zmiennych debugera. Użyj na przykład Natvis, aby dostosować ekrany w oknach Watch, Locals i Data Guidelines (Wskazówki dotyczące danych).

Funkcja Natvis jest domyślnie włączona, ale można ją wyłączyć w Visual Studio przez ustawienie menu Narzędzia > Opcje > Rozszerzenie Android Game Development > Natvis ustaw na Wyłączono.

Wczytuję pliki Natvis

Visual Studio wczytuje pliki Natvis z 3 lokalizacji wymienionych poniżej, ładują się ponownie po każdym rozpoczęciu sesji debugowania. Pliki muszą być zgodne z Schemat Visual Studio 2017 Natvis.

• .natvis pliki, które są częścią wczytanego projektu lub elementu rozwiązania najwyższego poziomu.
• W katalogu specyficznym dla użytkownika (%USERPROFILE%\Documents\Visual Studio 2017\Visualizers)
• W katalogu systemowym (%VSINSTALLDIR%\Common7\Packages\Debugger\Visualizers)

Ponownie ładuję pliki Natvis

Załaduj ponownie pliki Natvis podczas sesji debugowania, oceniając .natvisreload w Okno poleceń lub Watch.

Przykładowy plik Natvis

Ten przykładowy plik Natvis zawiera wszystkie tagi i atrybuty obsługiwane.

<?xml version="1.0" encoding="utf-8"?>
<AutoVisualizer xmlns="http://schemas.microsoft.com/vstudio/debugger/natvis/2010">

  <Type Name="demo::Vector&lt;*&gt;">
    <AlternativeType Name="MySimilarVectorType&lt;*&gt;"/>

    <!-- Included to show the <SmartPointer> feature is supported. -->
    <SmartPointer Optional="true" Usage="Minimal">ptr</SmartPointer>

    <!-- Included to show the <DisplayString> feature is supported. -->
    <DisplayString Condition="_size == 0" Optional="true">()</DisplayString>
    <DisplayString Condition="_size == 1">(x={_items[0]})</DisplayString>
    <DisplayString Condition="_size == 2">(x={_items[0]}, y={_items[1]})</DisplayString>
    <DisplayString Condition="_size == 3">(x={_items[0]}, y={_items[1]}, z={_items[2]})</DisplayString>
    <DisplayString>[Size={_size,x}] (x={_items[0]}, y={_items[1]}, z={_items[2]}, ...)</DisplayString>

    <!-- Included to show the <StringView> feature is supported. -->
    <StringView Condition="true" Optional="true">_stringViewText</StringView>

    <Expand HideRawView="false">
      <!-- Included to show the <Item> feature is supported. -->
      <Item Name="X" Condition="_size &lt; 4 &amp;&amp; _size &gt;= 1" Optional="true">_items[0]</Item>
      <Item Name="Y" Condition="_size &lt; 4 &amp;&amp; _size &gt;= 2" Optional="true">_items[1]</Item>
      <Item Name="Z" Condition="_size &lt; 4 &amp;&amp; _size &gt;= 3" Optional="true">_items[2]</Item>

      <!-- Included to show the <ArrayItems> feature is supported. -->
      <ArrayItems Condition="_size >= 4" Optional="true">
        <Size Condition="true" Optional="true">_size</Size>
        <ValuePointer Condition="true">_items</ValuePointer>
      </ArrayItems>

      <!-- Included to show the <IndexListItems> feature is supported. -->
      <IndexListItems Condition="true" Optional="true">
        <Size Condition="true" Optional="true">_listSize</Size>
        <ValueNode Condition="true">_list[%i]</ValueNode>
      </IndexListItems>

      <!-- Included to show the <LinkedListItems> feature is supported. -->
      <LinkedListItems Condition="true" Optional="true">
        <Size Optional="true">_listSize</Size>
        <HeadPointer>_head</HeadPointer>
        <NextPointer>_next</NextPointer>
        <ValueNode>_value</ValueNode>
      </LinkedListItems>

      <!-- Included to show the <ExpandedItem> feature is supported. -->
      <ExpandedItem Condition="true" Optional="true">_childVar</ExpandedItem>

      <!-- Included to show the <Synthetic> feature is supported. -->
      <Synthetic Name="[Size]" Condition="true" Optional="true">
        <DisplayString>_size</DisplayString>
        <Expand HideRawView="true">
          <!-- Any supported <Expand> sub-tags. -->
        </Expand>
      </Synthetic>

      <!-- Included to show the <TreeItems> feature is supported. -->
      <TreeItems Condition="true" Optional="true">
        <Size>_treeSize</Size>
        <HeadPointer>_head</HeadPointer>
        <LeftPointer>_left</LeftPointer>
        <RightPointer>_right</RightPointer>
        <ValueNode>_value</ValueNode>
      </TreeItems>

      <!-- Included to show format specifiers are supported. -->
      <Item Name="[Hex Dump at {_index,x}]">myInt[_index],x</Item>
    </Expand>
  </Type>
</AutoVisualizer>

Tworzenie plików Natvis

Visual Studio umożliwia tworzenie własnych plików Natvis. Więcej informacji na temat konfiguracji o dostosowywaniu okien zmiennych debugera znajdziesz w artykule MSDN.

Debugowanie plików Natvis

W niektórych przypadkach błędy będą przedstawiane jako Wartość zmiennej (np. w polu Auto, Zegarek itp.). Przykład: <error: use of undeclared identifier 'missingVar'>

Aby uzyskać więcej informacji o błędzie, otwórz GoogleAndroid.log na pasku narzędzi rozszerzenia Android Game Development Extension.

Znane ograniczenia

• Jeśli Twojego tagu lub atrybutu nie ma na liście w przykładowym pliku powyżej, nie są obecnie obsługiwane. Visual Studio ignoruje nieobsługiwane tagi i atrybuty, więc możesz zostawić je w istniejącym pliku Natvis. Plik będzie działać, korzysta z naszego schematu.

• Atrybut Usage, choć jest wymagany przez schemat, nie jest obsługiwany w przypadku <SmartPointer> LLDB nie ogranicza jednak dostępu do operatorów w języku C++, tak aby dowolny wymagany operator można było zdefiniować w C++.