Trendyol/android-dev-tools

Android Dev Tools

Android Dev Tools is a library that contains various QA/Debug tools to speed up and streamline the development progress.

Tools

• Autofill Service
• Analytics Logger
• Http Inspector (Alpha)
• Environment Manager
• Debug Menu
• DeepLink Launcher

Autofill Service

Autofill Service allows developers and QA to fill form inputs automatically with predefined form data.

How it Works?

It observes both activity and fragment lifecycle events via application class to detect layout inflations. After each inflation, it seeks for determined input views in the inflated layout. If it has all required inputs, then shows the autofill action. Autofill data that suitable with inflated form inputs are shown in the selection dialog.

Demo

Usage

AutofillService.Builder(this)
    .withFilePath("autofill.json")
    .build()

Configuration

Configuration Json file can be located in /debug/assets folder. You can define autofill data by following this structure. You should also note that the order of the defined form field resource id's and order of input values must match.

{
  "forms": [
    {
      "fields": ["inputEmail", "inputPassword"], // Form input resource id's
      "categories": {
        "Temporary Users": [
          { "description": "Has more then one order history.", "values": ["[email protected]", "123456"] },
          { "description": "Has more then one order history.", "values": ["[email protected]", "123456"] },
          { "description": "Has more then one order history.", "values": ["[email protected]", "123456"] },
          { "description": "Has more then one order history.", "values": ["[email protected]", "123456"] }
        ],
        "Test Users": [
          { "description": "Has more then one order history.", "values": ["[email protected]", "123456"] },
          { "description": "Has more then one order history.", "values": ["[email protected]", "123456"] },
          { "description": "Has more then one order history.", "values": ["[email protected]", "123456"] },
          { "description": "Has more then one order history.", "values": ["[email protected]", "123456"] }
        ]
      }
    }
  ]
}

Setup

"com.trendyol.android.devtools:autofill-service:$version"
"com.trendyol.android.devtools:autofill-service-no-op:$version"

Analytics Logger

Analytics Logger allows to log & inspect analytics events sent by client.

Demo

Usage

AnalyticsLogger.init(applicationContext)

AnalyticsLogger.report(
    key = "eventKey",
    value = "{\"category\": \"Cart\", \"data\": \"TestData\" }", // Should be Json string.
    platform = "EventPlatform",
)

Setup

"com.trendyol.android.devtools:analytics-logger:$version"
"com.trendyol.android.devtools:analytics-logger-no-op:$version"

Http Inspector (Alpha)

Http Inspector provides an OkHttp interceptor and web interface to inspect, manipulate in realtime and mock HTTP request and responses.

You can access the web client with http://deviceip:5001. If you are running on virtual a device, you need to forward port by adb forward tcp:5001 tcp:5001.

How it Works

Mocking Requests

Usage

val client = OkHttpClient.Builder()
    .addInterceptor(MockInterceptor(context))
    .build()

Setup

"com.trendyol.android.devtools:http-inspector:$version"
"com.trendyol.android.devtools:http-inspector-no-op:$version"

Environment Manager

Environment Manager provides environment selection dialog can be opened from the app notifications with predefined environment data.

Setup

"com.trendyol.android.devtools:environment-manager:$version"

Debug Menu

Debug Menu provides a debug page build with predefined custom action and events.

Setup

"com.trendyol.android.devtools:debug-menu:$version"

DeepLink Launcher(Beta)

DeepLink Launcher allows you, trigger deepLinks, and keep triggered deepLinks in history.

When a deepLink launched, it will be recorded to roomDB. And recorded datas will be listed under the History Tab.

And also you can import your deepLinks data to DeepLink Launcher. They will be listed under the APP'S DEEPLINK tab.

Demo

Initialize

You need to initialize it first

DeepLinkLauncher.init(this)

If you have a deepLink json file which is includes your app deepLinks, you can init them like that. That's an optional area.

DeepLinkLauncher.importAppDeepLinks(jsonString)

For importing external list to DeepLink Launcher, your json format be like that sample:

{
    "deepLinks": [
        "dl://?Page=Home&Tab=Man",
        "dl://?Page=AppLink&Data=1",
        "dl://?Page=AppLink&Data=2"
    ]
}

Usage

And just call this function to open DeepLink Launcher screen.

DeepLinkLauncher.show()

Setup

"com.trendyol.android.devtools:deeplink-launcher:$version"

License

Copyright 2022 Trendyol.com

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.