lin
2025-08-14 dae8bad597b6607a449b32bf76c523423f7720ed
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
#ifndef _TCUAPP_HPP
#define _TCUAPP_HPP
/*-------------------------------------------------------------------------
 * drawElements Quality Program Tester Core
 * ----------------------------------------
 *
 * Copyright 2014 The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 *
 *//*!
 * \file
 * \brief Tester application.
 *
 * Platform port (see tcuPlatform.hpp) must create App and issue calls to
 * App::iterate() until it signals that test execution is completed.
 *//*--------------------------------------------------------------------*/
 
#include "tcuDefs.hpp"
#include "qpWatchDog.h"
#include "qpCrashHandler.h"
#include "deMutex.hpp"
 
namespace tcu
{
 
class Archive;
class Platform;
class TestContext;
class TestSessionExecutor;
class CommandLine;
class TestLog;
class TestPackageRoot;
class TestRunStatus;
 
enum
{
   WATCHDOG_TOTAL_TIME_LIMIT_SECS        = 300,
   WATCHDOG_INTERVAL_TIME_LIMIT_SECS    = 30
};
 
/*--------------------------------------------------------------------*//*!
 * \brief Test application
 *
 * Test application encapsulates full test execution logic. Platform port
 * must create App object and repeately call iterate() until it returns
 * false.
 *
 * On systems where main loop is not in control of application (such as
 * Android or iOS) iterate() should be called in application update/draw
 * callback.
 *
 * App is responsible of setting up crash handler (qpCrashHandler) and
 * watchdog (qpWatchDog).
 *
 * See tcuMain.cpp for an example on how to implement application stub.
 *//*--------------------------------------------------------------------*/
class App
{
public:
                           App                    (Platform& platform, Archive& archive, TestLog& log, const CommandLine& cmdLine);
   virtual                    ~App                (void);
 
   bool                    iterate                (void);
   const TestRunStatus&    getResult            (void) const;
 
protected:
   void                    cleanup                (void);
 
   void                    onWatchdogTimeout    (qpTimeoutReason reason);
   void                    onCrash                (void);
 
   static void                onWatchdogTimeout    (qpWatchDog* watchDog, void* userPtr, qpTimeoutReason reason);
   static void                onCrash                (qpCrashHandler* crashHandler, void* userPtr);
 
   Platform&                m_platform;
   qpWatchDog*                m_watchDog;
   qpCrashHandler*            m_crashHandler;
   de::Mutex                m_crashLock;
   bool                    m_crashed;
 
   TestContext*            m_testCtx;
   TestPackageRoot*        m_testRoot;
   TestSessionExecutor*    m_testExecutor;
};
 
} // tcu
 
#endif // _TCUAPP_HPP