Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Việc tạo hành trình cho Android Studio giúp bạn dễ dàng viết và duy trì các quy trình kiểm thử toàn diện bằng cách cho phép bạn sử dụng ngôn ngữ tự nhiên để mô tả các bước và câu lệnh khẳng định cho từng quy trình kiểm thử (gọi là hành trình). Bằng cách tận dụng khả năng thị giác và suy luận của Gemini, các bước được viết bằng ngôn ngữ tự nhiên sẽ được chuyển đổi thành những hành động mà Gemini thực hiện trên ứng dụng của bạn, giúp bạn dễ dàng viết và hiểu được hành trình của mình. Ngoài ra, bạn có thể viết và mô tả các câu lệnh phức tạp hơn. Gemini sẽ đánh giá các câu lệnh này dựa trên những gì mà Gemini thấy trên thiết bị để xác định xem hành trình của bạn có thành công hay không.
Và vì Gemini suy luận về những hành động cần thực hiện để đáp ứng các mục tiêu, nên các hành trình sẽ có khả năng thích ứng tốt hơn với những thay đổi nhỏ về bố cục hoặc hành vi của ứng dụng, dẫn đến ít thử nghiệm không ổn định hơn khi chạy trên các phiên bản ứng dụng và cấu hình thiết bị khác nhau.
Viết và chạy các hành trình ngay trong Android Studio trên mọi thiết bị Android cục bộ hoặc từ xa. IDE cung cấp một trải nghiệm trình chỉnh sửa mới để tạo hành trình cũng như kết quả nhiều định dạng giúp bạn hiểu rõ hơn về quá trình suy luận và thực hiện hành trình của Gemini.
Viết nhật ký
Android Studio cung cấp một mẫu tệp và trải nghiệm trình chỉnh sửa mới giúp bạn dễ dàng tạo và chỉnh sửa hành trình. Hành trình được viết bằng cú pháp XML để sắp xếp nội dung mô tả và các bước trong hành trình.
Để tạo và bắt đầu chỉnh sửa một hành trình, hãy làm như sau:
Trong bảng điều khiển Project (Dự án) trong Android Studio, hãy nhấp chuột phải vào mô-đun ứng dụng mà bạn muốn viết hành trình.
Chọn New > Test > Journey File (Mới > Thử nghiệm > Tệp hành trình).
Trong hộp thoại xuất hiện, hãy cung cấp tên và nội dung mô tả cho hành trình của bạn.
Nhấp vào OK. Android Studio sẽ tạo một tệp XML cho hành trình của bạn bằng tên mà bạn đã chọn. Bạn có thể sử dụng chế độ xem Code (Mã) để chỉnh sửa trực tiếp XML hoặc chế độ xem Design (Thiết kế) để có trải nghiệm chỉnh sửa tốt hơn.
Khi xem hành trình của bạn ở chế độ xem Thiết kế, hãy sử dụng trường văn bản để mô tả từng bước trong hành trình. Mỗi bước có thể bao gồm các hành động mô tả mà bạn muốn Gemini thực hiện hoặc các câu khẳng định mà bạn muốn Gemini đánh giá.
Nhấn phím Enter trên bàn phím để bắt đầu một câu lệnh mới trong cùng một hành trình. Bạn có thể lặp lại bước này khi cần cho từng bước trong hành trình mà bạn muốn xác định.
Mẹo viết hành trình
Việc viết hành trình một cách chi tiết và có tổ chức có thể làm tăng khả năng Gemini chạy chính xác hành trình mà bạn muốn theo cách có tính xác định hơn. Sau đây là một số mẹo giúp bạn viết hành trình hiệu quả hơn:
Tách các câu khẳng định khỏi các hành động: Gemini liên tục đánh giá trạng thái của ứng dụng để xác định xem ứng dụng có ở trạng thái "chính xác" để tiếp tục hành trình hay không.
Tuy nhiên, bạn có thể cần xác định các câu khẳng định phức tạp hơn dưới dạng một bước riêng biệt.
Ngoài ra, hãy bắt đầu mỗi câu lệnh bằng các cụm từ khoá như "Xác minh rằng", "Khẳng định rằng" hoặc "Kiểm tra rằng" để cho Gemini biết rằng bước này là một khẳng định.
Chỉ dẫn Gemini bằng thao tác vuốt: Ngoài các thao tác tương tác cơ bản, chẳng hạn như nhấn hoặc nhập bằng bàn phím, Gemini còn hỗ trợ những thao tác yêu cầu vuốt màn hình theo một số hướng nhất định. Ví dụ: để cuộn qua nội dung hoặc đóng một số giao diện người dùng, bạn chỉ cần mô tả hướng và mục đích của thao tác vuốt. Theo mặc định, Gemini sẽ vuốt từ giữa màn hình, nhưng bạn có thể hướng dẫn Gemini vuốt ở một phần khác trên màn hình thiết bị.
Tránh các tương tác và thay đổi về cấu hình phức tạp: Gemini hiện không hỗ trợ tất cả các tương tác và thay đổi về cấu hình, chẳng hạn như cử chỉ nhiều ngón tay, xoay màn hình hoặc hành động gập. Nhóm chúng tôi đang nỗ lực cải thiện các tính năng của Gemini.
Chạy hành trình
Bạn có thể chạy hành trình trên mọi thiết bị cục bộ hoặc từ xa hiện có, tương tự như mọi kiểm thử đo lường khác và Android Studio sẽ tạo ra kết quả chi tiết giúp bạn hiểu được quá trình thực thi hành trình.
Để kiểm thử một hành trình, hãy làm như sau:
Chọn một thiết bị mục tiêu trên thanh công cụ chính, giống như khi bạn chạy một kiểm thử đo lường.
Chuyển đến tệp XML của hành trình mà bạn muốn kiểm thử rồi mở tệp đó trong trình chỉnh sửa.
Trong trình chỉnh sửa, hãy thực hiện một trong những thao tác sau:
Nếu bạn đang ở chế độ xem Thiết kế, hãy nhấp vào Chạy hành trình.
Nếu bạn đang ở chế độ xem Code (Mã), hãy nhấp vào Run (Chạy) trong rãnh bên cạnh vị trí tên của hành trình được xác định trong XML.
Android Studio sẽ tạo cấu hình Journeys Test (Kiểm thử hành trình) cho bạn và chạy cấu hình đó trên thiết bị mục tiêu. Trong quá trình thực thi, Android Studio sẽ tạo và triển khai ứng dụng của bạn, đồng thời kết nối với Gemini để xác định những hành động cần thực hiện cho từng bước trong hành trình của bạn.
Kết quả bị giới hạn cũng xuất hiện trong trình chỉnh sửa khi bạn chạy một hành trình, chẳng hạn như ảnh chụp màn hình, hành động đã thực hiện và lý do trong quá trình thực thi từng bước trong hành trình của bạn. Bạn chỉ cần di chuột lên hình thu nhỏ trong trình chỉnh sửa để xem thêm thông tin. Điều này có thể hữu ích khi bạn lặp lại các câu lệnh trong hành trình của mình.
Xem kết quả
Khi Android Studio hoàn tất việc kiểm thử hành trình của bạn, bảng kết quả kiểm thử sẽ tự động xuất hiện để cho bạn thấy kết quả.
So với các kiểm thử được đo lường khác mà bạn có thể chạy trong Android Studio, có một số điểm khác biệt về cách hiển thị kết quả cho các hành trình.
Bảng Kiểm thử chia hành trình thành các bước riêng biệt. Bạn có thể nhấp vào từng bước để tìm hiểu thêm thông tin về cách Gemini thực hiện bước đó.
Bảng Kết quả cho thấy thông tin phong phú để giúp bạn hiểu cách Gemini hiểu và suy luận về hành trình của bạn, cũng như cách hành trình đó được thực hiện.
Ảnh chụp màn hình đã được gửi cho Gemini sẽ xuất hiện để hỗ trợ trực quan cho từng hành động trong bước.
Mỗi hành động được thực hiện và lý do Gemini thực hiện hành động đó được mô tả bên cạnh mỗi ảnh chụp màn hình.
Mỗi thao tác trong bước đều được đánh số.
Vấn đề đã biết
Khi kiểm thử một hành trình, theo mặc định, tất cả các quyền cho ứng dụng của bạn đều được cấp.
Khi kiểm thử một hành trình trên thiết bị chạy Android 15 (API cấp 35), bạn có thể thấy cảnh báo "Ứng dụng không an toàn bị chặn" cho "AndroidX Crawler" trên thiết bị. Bạn có thể nhấp vào Cài đặt dù sao để bỏ qua bước kiểm tra này.
Ngoài ra, bạn có thể Định cấu hình các tuỳ chọn cho nhà phát triển trên thiết bị và tắt tuỳ chọn Xác minh ứng dụng qua USB.
Hiện tại, các tệp hành trình không xuất hiện trong chế độ xem Android trong bảng Projects (Dự án). Để xem các tệp hành trình trong dự án, hãy sử dụng chế độ xem Project (Dự án).
Nếu nhiều hành động trong một hành trình có cùng một câu lệnh, thì kết quả kiểm thử xuất hiện trong trình chỉnh sửa hành trình có thể không chính xác. Cụ thể, tất cả các thao tác có lời nhắc trùng lặp sẽ cho thấy kết quả kiểm thử liên quan đến phiên bản được cập nhật gần đây nhất của lời nhắc đó. Để khắc phục vấn đề này, hãy đảm bảo mỗi thao tác đều có một câu lệnh riêng biệt, chẳng hạn như bằng cách thêm một tiền tố hoặc hậu tố riêng biệt.
Cửa sổ bật lên bút cảm ứng sẽ xuất hiện vào lần thứ hai bàn phím được tải trên một trình mô phỏng mới. Cửa sổ bật lên này thường khiến các kiểm thử tương tác với trường văn bản không thành công. Khi điều này xảy ra, hãy đóng cửa sổ bật lên và chạy lại hành trình.
Đôi khi, các cấu phần phần mềm của trình thu thập dữ liệu ứng dụng có thể xuất hiện trong lý do của tác nhân.
Đôi khi, quá trình thực thi hành trình không thành công với IllegalStateException. Khi điều này xảy ra, bạn có thể nhấp vào Kết quả kiểm thử để xem toàn bộ lỗi.
Nếu Trình bổ trợ Android cho Gradle (com.android.application) không được xác định trong tệp build.gradle cấp cao nhất, thì bạn có thể thấy lỗi sau khi chạy một hành trình:
Failed to apply plugin class 'com.android.tools.journeys.JourneysGradlePlugin'
Để giải quyết vấn đề này, hãy đảm bảo rằng trình bổ trợ được xác định trong tệp build.gradle cấp cao nhất. Hãy xem bài viết Định cấu hình hệ thống tạo bản dựng Android để biết thêm thông tin.
Nội dung và mã mẫu trên trang này phải tuân thủ các giấy phép như mô tả trong phần Giấy phép nội dung. Java và OpenJDK là nhãn hiệu hoặc nhãn hiệu đã đăng ký của Oracle và/hoặc đơn vị liên kết của Oracle.
Cập nhật lần gần đây nhất: 2025-08-09 UTC.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-08-09 UTC."],[],[],null,["# Journeys for Android Studio\n\n| **Preview:** Journeys for Android Studio are available starting from Android Studio Narwhal Feature Drop \\| 2025.1.3.\n\nCreating journeys for Android Studio helps make end-to-end tests easy to write\nand maintain by letting you use natural language to describe the steps and\nassertions for each test---called a journey. By leveraging Gemini's vision and\nreasoning capabilities, steps written in natural language are converted into\nactions that Gemini performs on your app, making it both easy to write and\nunderstand your journeys. Additionally, you can write and describe more complex\nassertions, which Gemini evaluates based on what it sees on the device in order\nto determine whether your journeys pass or fail. \n\nAnd because Gemini reasons about which actions to perform to satisfy the goals,\njourneys are more resilient to subtle changes to your app's layout or behavior,\nresulting in fewer flaky tests when running against different versions of your\napp and different device configurations.\n\nWrite and run journeys right from Android Studio against any local or remote\nAndroid device. The IDE provides a new editor experience for crafting journeys\nas well as rich results that help you better follow Gemini's reasoning and\nexecution of your journey.\n| **Note:** Before you get started, download the latest [Canary version of Android\n| Studio](/studio/preview). You'll also need to make sure that you're signed into your developer account and have enabled Gemini in Android Studio.\n\nWrite a journey\n---------------\n\nAndroid Studio provides a file template and new editor experience that makes\ncreating and editing journeys easy. Journeys are written using the XML syntax to\norganize your journey description and steps.\n\nTo create and start editing a journey, do the following:\n\n1. From the **Project** panel in Android Studio, right-click on the app module for which you want to write a journey.\n2. Select **New \\\u003e Test \\\u003e Journey File**.\n3. In the dialog that appears, provide the name and description of your journey.\n4. Click **OK** . Android Studio creates an XML file for your journey with the name you chose. You can use either the **Code** view to edit the XML directly, or the **Design** view for an improved editing experience.\n5. When viewing your journey in the **Design** view, use the text field to describe each step of your journey. Each step can include descriptive actions you want Gemini to perform or assertions that you want Gemini to evaluate.\n6. Press \u003ckbd\u003eEnter\u003c/kbd\u003e on your keyboard to start a new prompt in the same journey. You can repeat this as needed for each step of the journey you want to define.\n\n### Tips for writing journeys\n\nWriting your journeys in a detailed and organized way can increase the\nlikelihood of Gemini accurately running your intended journeys in a more\ndeterministic way. Here are some tips to help you write your journeys more\neffectively:\n\n- **Separate assertions from actions:** Gemini constantly evaluates the state of your app to determine if it's in a \"correct\" state to continue the journey. However, you might need to define more complex assertions as a separate step. Additionally, start each prompt using key phrases such as \"Verify that,\" \"Assert that,\" or \"Check that\" to let Gemini know that this step is meant to be an assertion.\n- **Direct Gemini with swipes:** In addition to basic interactions, such as tapping or keyboard inputs, Gemini supports actions that require it to swipe the screen in certain directions. For example, to scroll through content or dismiss some UI simply describe the direction and intent of your swipe action. By default, Gemini swipes from the center of the screen, but you can guide it to swipe on a different part of the device screen.\n- **Avoid complex interactions and configuration changes:** Gemini currently does not support all interactions and configuration changes, such as multi-finger gestures, screen rotations, or folding actions. The team is working to improve Gemini capabilities.\n\nRun your journey\n----------------\n\nYou can run your journey on any available local or remote device, similar to any\nother instrumented test, and Android Studio generates rich results that help you\nunderstand the execution of your journey.\n\nTo test a journey, do the following:\n\n1. Select a target device from the main toolbar, like you would when running an instrumented test.\n2. Navigate to the journey XML file that you would like to test and open it in the editor.\n3. In the editor, do one of the following:\n 1. If you're in the **Design** view, click **Run Journey**.\n 2. If you're in the **Code** view, click **Run** in the gutter next to where the name of the journey is defined in the XML.\n\nAndroid Studio creates a **Journeys Test** configuration for you and runs it on\nthe target device. During execution, Android Studio builds and deploys your app,\nand connects to Gemini to determine which actions to take for each step of your\njourney.\n\nLimited results are also shown in the editor while running a journey, such as\nthe screenshots, action taken, and reasoning during the execution of each step\nin your journey. Simply hover over the thumbnail in the editor to see more\ninformation. This can be helpful when iterating on the prompts in your journey.\n\nView results\n------------\n\nWhen Android Studio completes testing your journey, the test results panel\nappears automatically to show you the results.\n\nCompared to other instrumented tests you might run in Android Studio, there are\nsome differences in how results for journeys are displayed.\n\n- The **Tests** panel breaks down the journey into the discrete steps. You can click on each step to find out more information about how Gemini executed it.\n- The **Results** panel shows rich information to help you understand how Gemini understood and reasoned about your journey, and how it was executed.\n- The screenshots that were sent to Gemini are shown for visual aid at each action in the step.\n- Each action taken and Gemini's reasoning for why it took that action is described next to each screenshot.\n- Each action in the step is numbered.\n\nKnown issues\n------------\n\n- When testing a journey, all permissions for your app are granted by default.\n- When testing a journey on a device running Android 15 (API level 35), you might see a warning on the device that says \"Unsafe App Blocked\" for \"AndroidX Crawler\". You can click **Install anyway** to bypass this check. Alternatively, you can [Configure on-device developer options](/studio/debug/dev-options) and disable the option to **Verify apps over USB**.\n- Journey files do not currently appear in the **Android** view in the **Projects** panel. To see journey files in your project, use the **Project** view.\n- If multiple actions within a journey share the exact same prompt, the test results displayed in the journey editor may be incorrect. Specifically, all actions with the duplicate prompt will show the test results associated with the most recently updated instance of that prompt. To work around this, ensure each action has a unique prompt---for example, by adding a distinct prefix or suffix.\n- A stylus popup appears the second time the keyboard is loaded on a fresh emulator. This popup usually causes tests that interact with text fields to fail. When this occurs, dismiss the popup and rerun the journey.\n- App crawler artifacts might occasionally appear in agent rationale.\n- Journey execution occasionally fails with an `IllegalStateException`. When this happens, you can click on **Test Results** to see the full error.\n- If the Android Gradle Plugin (`com.android.application`) isn't defined in the\n top-level `build.gradle` file, you may see the following error when running a\n journey:\n\n Failed to apply plugin class 'com.android.tools.journeys.JourneysGradlePlugin'\n\n To resolve this, ensure that the plugin is defined in the top-level\n `build.gradle` file. See [Configure the Android build system](/build#top-level)\n for more information."]]
Chạy hành trình.
Run 