RobotFramework+Appium测试Angular混合安卓App的XPath定位问题

问题场景 #

使用RobotFramework结合Appium 1.6.3测试公司混合安卓App（包含Native安卓和Angular Web上下文）时，处于Web上下文执行元素定位：

• 采用XPath表达式Click Element //*[contains(@text,some_containing_text)]定位含指定文本的元素，返回的却是包含目标元素的根元素，导致点击位置错误。
• 相同定位逻辑在Selenium测试纯Web应用时可正常工作，当前需定位文本为Ukončit的span元素。

目标元素对应的HTML结构 #

<app-attendance-detail class="ng-star-inserted">
<div class="py-4">
    <div class="container-fluid">
        <div class="row">
            <div class="col-12">
                <div class="mb-4">
                    <div class="row">
                        <div class="col-12"><h4 class="fs-14 mb-1 font-weight-bold">úterý, 09:56:00 26.07.2022</h4>
                        </div>
                    </div>
                    <h4 class="fs-14 fs-md-16 mb-4 font-weight-bold text-gray-light ng-star-inserted">
                        <span>Začátek dnešní směny od</span> dnes v 9:45 </h4>
                    <div class="e-timer text-gray ng-star-inserted">00:10h</div>
                    <a href="#" title="#" preventdefault="" 
                       class="btn btn-primary w-100 text-uppercase font-weight-bold px-9 mt-6 ng-star-inserted"><i
                        class="icon icon-stop position-relative bottom-1 mr-1"></i><span translate="" 
                                                                                         ng-reflect-translate="">Ukončit</span></a>
                    <div class="row row-xs mt-2 ng-star-inserted">
                        <div class="col-6 px-1"><a href="#" title="#" preventdefault="" 
                                                   class="btn btn-white border-primary-dark text-primary w-100 text-uppercase font-weight-bold px-9"><i
                            class="icon icon-pause position-relative bottom-1 mr-1"></i><span>Začátek<br>přestávky</span></a>
                        </div>
                        <div class="col-6 px-1"><a href="#" title="#" preventdefault="" 
                                                   class="btn btn-white border-primary-dark text-primary w-100 text-uppercase font-weight-bold px-9"><span>Odchod<br>jiné</span></a>
                        </div>
                    </div>
                </div>
                <div class="mt-4"><h4 translate="" class="fs-14 fs-md-16 mb-2 font-weight-bold" 
                                      ng-reflect-translate="">Docházka</h4><a title="#" target="_blank" 
                                                                              class="d-block bg-white px-3 border-radius-sm box-shadow-sm mb-2 text-gray ng-star-inserted" 
                                                                              href="https://h5tws.cezdata.corp:44320/sap/bc/bsp/sap/zjd_dovol/overview.htm">
                    <div class="row">
                        <div class="col py-3 pb-3">
                            <div translate="" class="fs-16 font-weight-bold text-uppercase" ng-reflect-translate="">
                                Žádost o dovolenou
                            </div>
                        </div>
                        <div
                            class="col col-xs py-2 text-center border-left border-gray-light d-flex align-items-center justify-content-center">
                            <div class="text-gray"><i class="icon icon-forward"></i></div>
                        </div>
                    </div>
                </a><a title="#" target="_blank" 
                       class="d-block bg-white px-3 border-radius-sm box-shadow-sm mb-2 text-gray ng-star-inserted" 
                       href="https://h5tws.cezdata.corp:44320/sap/bc/bsp/sap/zjd_doli/selection_screen.htm">
                    <div class="row">
                        <div class="col py-3 pb-3">
                            <div translate="" class="fs-16 font-weight-bold text-uppercase" ng-reflect-translate="">
                                Docházkový list
                            </div>
                        </div>
                        <div
                            class="col col-xs py-2 text-center border-left border-gray-light d-flex align-items-center justify-content-center">
                            <div class="text-gray"><i class="icon icon-forward"></i></div>
                        </div>
                    </div>
                </a></div>
                <div class="mt-4"><h4 translate="" class="fs-14 fs-md-16 mb-2 font-weight-bold" 
                                      ng-reflect-translate="">Záznamy</h4><a routinglink="attendance/records" 
                                                                             href="#" title="#" 
                                                                             class="d-block bg-white px-3 border-radius-sm box-shadow-sm mb-2 text-gray" 
                                                                             ng-reflect-routing-link="attendance/records">
                    <div class="row">
                        <div class="col py-3 pb-3">
                            <div translate="" class="fs-16 font-weight-bold text-uppercase" ng-reflect-translate="">
                                Přehled záznamů
                            </div>
                        </div>
                        <div
                            class="col col-xs py-2 text-center border-left border-gray-light d-flex align-items-center justify-content-center">
                            <div class="text-gray"><i class="icon icon-forward"></i></div>
                        </div>
                    </div>
                </a></div>
            </div>
        </div>
    </div>
    <app-modal-dialog styleclass="shadow" ng-reflect-style-class="shadow" ng-reflect-show-header="false" 
                      ng-reflect-dismissable-mask="false" ng-reflect-dialog-id="4">
        <p-dialog class="p-element ng-tns-c30-7 ng-star-inserted" ng-reflect-style-class="shadow" 
                  ng-reflect-visible="false" ng-reflect-modal="true" ng-reflect-dismissable-mask="false" 
                  ng-reflect-transition-options="0ms" ng-reflect-show-header="false" ng-reflect-draggable="true" 
                  ng-reflect-resizable="true" ng-reflect-close-on-escape="true" ng-reflect-base-z-index="1050">
        </p-dialog>
    </app-modal-dialog>
    <app-modal-dialog styleclass="shadow" ng-reflect-style-class="shadow" ng-reflect-show-header="false" 
                      ng-reflect-dialog-id="5" ng-reflect-dismissable-mask="false">
        <p-dialog class="p-element ng-tns-c30-8 ng-star-inserted" ng-reflect-style-class="shadow" 
                  ng-reflect-visible="false" ng-reflect-modal="true" ng-reflect-dismissable-mask="false" 
                  ng-reflect-transition-options="0ms" ng-reflect-show-header="false" ng-reflect-draggable="true" 
                  ng-reflect-resizable="true" ng-reflect-close-on-escape="true" ng-reflect-base-z-index="1050">
        </p-dialog>
    </app-modal-dialog>
</div>

当前使用的Robot测试关键字 #

Attendance_action
[Arguments]        ${action}
Click element      //*[contains(@text, "${action}")]
Sleep              2s

问题原因及解决方案 #

原因分析 #

1. XPath语法误用：在Web上下文的HTML中，元素的文本内容是节点文本，而非text属性。你使用的@text是错误的属性引用，标准写法应该用text()函数获取元素的文本内容。Selenium中可能因兼容逻辑让@text偶然生效，但Appium 1.6.3的WebView处理逻辑严格，导致父元素（包含目标span的a标签甚至上层容器）因为包含目标文本被匹配到。
2. Appium版本兼容性：Appium 1.6.3属于较旧版本，对WebView的XPath支持和Selenium存在差异，新版本已优化这部分逻辑。

解决方案 #

1. 修正XPath表达式：使用text()函数匹配元素文本，同时指定元素类型缩小范围，避免匹配到父元素：

   Attendance_action
   [Arguments]        ${action}
   Click element      //span[contains(text(), "${action}")]
   Sleep              2s
   

   如果需要更精确定位，可以结合元素的其他属性（比如该span的translate属性）：

   Click element      //span[@translate="" and contains(text(), "${action}")]
   

2. 升级Appium版本：如果项目允许，升级到较新版本的Appium（如1.22+），提升WebView测试的兼容性和稳定性。

内容的提问来源于stack exchange，提问作者Adam