Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
23 commits
Select commit Hold shift + click to select a range
813c352
ADFA-7137 Add debugger_endpoint_table and migration 5 to 6
davidschachterADFA Nov 16, 2026
6adec66
style: spotless reformat, no functional change
davidschachterADFA Nov 16, 2026
4a97c77
ADFA-7137 Pair apps with projects and receive their debugger endpoint
davidschachterADFA Nov 16, 2026
b36bb6f
ADFA-7137 Send the debugger endpoint to Code on the Go once the serve…
davidschachterADFA Nov 16, 2026
6dd7340
ADFA-7137 Docs: describe the debugger endpoint and database version 6
davidschachterADFA Nov 16, 2026
2b759e6
ADFA-7137 Clear pending installs on failure and pin the endpoint broa…
davidschachterADFA Nov 16, 2026
a49098e
ADFA-7137: Merge ADFA-7135 (with #2244's sqlite-js 1.4.3) up the stack
davidschachterADFA Nov 16, 2026
8410499
ADFA-7137: Merge ADFA-7135 (README corrections) up the stack
davidschachterADFA Nov 16, 2026
2fecac4
ADFA-7137: Merge ADFA-7135 (F18 one-statement check, F19 tool deadlin…
davidschachterADFA Nov 17, 2026
8ed3fc6
ADFA-7137: Merge ADFA-7135 (F37 backstop rollback, F38 get_schema tru…
davidschachterADFA Nov 17, 2026
691cb38
ADFA-7137: Merge ADFA-7135 (F51 app functions, F52 get_schema limits)…
davidschachterADFA Nov 17, 2026
b8ea689
ADFA-7137: Merge ADFA-7135 (F108 integrity_check app functions, F109 …
davidschachterADFA Nov 17, 2026
2077542
Merge sqlite-debugger/ADFA-7135 into sqlite-debugger/ADFA-7137
davidschachterADFA Nov 17, 2026
d1bece3
ADFA-7137: Merge ADFA-7135 (F149 consumer rules, F151 recheck path, F…
davidschachterADFA Nov 17, 2026
bd579d9
ADFA-7137: Merge ADFA-7135 (F168 batch bound KDoc, F169 README batch …
davidschachterADFA Nov 17, 2026
e0bff8b
ADFA-7137: Merge ADFA-7135 (F172 first-row exception to the 4 MiB cap…
davidschachterADFA Nov 17, 2026
c327c69
ADFA-7137: Merge ADFA-7135 (F181 half-deadline KDoc, and stage with #…
davidschachterADFA Nov 17, 2026
1d12027
ADFA-7137 Re-send the endpoint when Code on the Go asks
davidschachterADFA Nov 18, 2026
6d8c81c
ADFA-7137 Pair a slow install with the open project at launch
davidschachterADFA Nov 18, 2026
7bd6675
ADFA-7137 Pair each install by its PackageInstaller session, in the a…
davidschachterADFA Nov 18, 2026
c45aae3
ADFA-7137 Drop the install note when the session cannot be committed
davidschachterADFA Nov 18, 2026
95660de
ADFA-7137 Pair nothing on a success result that names no package
davidschachterADFA Nov 18, 2026
10e4c47
ADFA-7137 Docs: Quick Build's installs are never paired
davidschachterADFA Nov 18, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion ARCHITECTURE.md
Original file line number Diff line number Diff line change
Expand Up @@ -144,7 +144,7 @@ Local builds get `documentation.db` from dev-assets instead, which is updated by

> **Persistence policy (authoritative):** new relational/queryable persistence uses **Room** (`@Entity` + DAO + `RoomDatabase` with explicit migrations, provided via Koin). Non-relational settings use the **filesystem/preferences (DataStore)**. **Raw SQLite is the exception, not the default** — see [ADR 0001](docs/adr/0001-prefer-room-for-persistence.md).
>
> **Recent Projects** is the reference example of the default: `app/src/main/java/com/itsaky/androidide/roomData/recentproject/` (`RecentProjectRoomDatabase`, `@Database version = 4` with migrations 1→4; `RecentProjectDao`; the `RecentProject` `@Entity` → table `recent_project_table`). It's provided via Koin in `di/AppModule.kt` and consumed by `RecentProjectsViewModel`, `ProjectInfoBottomSheet`, and `ProjectCreationManager` directly, and by `MainActivity`/`EditorHandlerActivity` indirectly through `RecentProjectRepository` (`repositories/RecentProjectRepository.kt`) -- kept behind that interface, rather than injecting the DAO into those two Activities directly, per this section's own UI -> ViewModel -> Repository -> data source layering.
> **Recent Projects** is the reference example of the default: `app/src/main/java/com/itsaky/androidide/roomData/recentproject/` (`RecentProjectRoomDatabase`, `@Database version = 6` with migrations 1→6; the `DebuggerEndpoint` `@Entity` → table `debugger_endpoint_table` pairs an app with its project through a foreign key to `recent_project_table.location`; `RecentProjectDao`; the `RecentProject` `@Entity` → table `recent_project_table`). It's provided via Koin in `di/AppModule.kt` and consumed by `RecentProjectsViewModel`, `ProjectInfoBottomSheet`, and `ProjectCreationManager` directly, and by `MainActivity`/`EditorHandlerActivity` indirectly through `RecentProjectRepository` (`repositories/RecentProjectRepository.kt`) -- kept behind that interface, rather than injecting the DAO into those two Activities directly, per this section's own UI -> ViewModel -> Repository -> data source layering.
>
> **Raw SQLite is allowed only when** the database is prebuilt and opened read-only, the data is performance/allocation-critical and needs granular schema control, or the schema is shared across a process/component boundary. Current exceptions: symbol indexing (`lsp/indexing/SQLiteIndex.kt`), tooltips (`idetooltips/ToolTipManager.kt`), in-app/plugin help (`plugin-manager/.../documentation/PluginDocumentationManager.kt` — the one *writer*, inserting plugin-contributed rows into a schema owned elsewhere), the shared compression-dictionary loader (`common/.../utils/DocumentationCompression.kt`), and documentation serving (`common/.../documentation/DocumentationContentSource.kt`, the one read pipeline behind both the in-process WebView transport and `app/.../localWebServer/WebServer.kt`). The `androidx.room:*` strings in `editor`'s `GroovyAutoComplete` are autocomplete suggestions for the *user's* code, not CoGo persistence.
>
Expand Down
12 changes: 12 additions & 0 deletions app/src/main/AndroidManifest.xml
Original file line number Diff line number Diff line change
Expand Up @@ -360,6 +360,18 @@
</intent-filter>
</receiver>

<!-- The SQLite debugger library in an app built here reports its token and port. The sender
is another app, so it is exported; the receiver ignores apps it has no pairing row for. -->
<receiver
android:name=".sqlitedebugger.DebuggerEndpointReceiver"
android:enabled="true"
android:exported="true"
tools:ignore="ExportedReceiver">
<intent-filter>
<action android:name="com.itsaky.androidide.SQLITE_DEBUGGER_ENDPOINT" />
</intent-filter>
</receiver>

<!--
Receiver used to receive broadcasts when foreground application changes
This receiver *must* have permissions that are not usually granted to
Expand Down
137 changes: 76 additions & 61 deletions app/src/main/java/com/itsaky/androidide/actions/etc/LaunchAppAction.kt
Original file line number Diff line number Diff line change
Expand Up @@ -27,77 +27,92 @@ import com.itsaky.androidide.actions.markInvisible
import com.itsaky.androidide.actions.openApplicationModuleChooser
import com.itsaky.androidide.idetooltips.TooltipTag.EDITOR_TOOLBAR_LAUNCH_APP
import com.itsaky.androidide.projects.IProjectManager
import com.itsaky.androidide.repositories.DebuggerEndpointRepository
import com.itsaky.androidide.utils.IntentUtils
import com.itsaky.androidide.utils.flashError
import kotlinx.coroutines.launch
import org.koin.core.context.GlobalContext
import org.slf4j.LoggerFactory
import java.io.File

/**
* An action to launch the already installed application on the device.
*
* @author Akash Yadav
*/
class LaunchAppAction(context: Context, override val order: Int) : EditorActivityAction() {

override val id: String = "ide.editor.launchInstalledApp"
override var requiresUIThread: Boolean = true
override fun retrieveTooltipTag(isReadOnlyContext: Boolean) = EDITOR_TOOLBAR_LAUNCH_APP

init {
label = context.getString(R.string.title_launch_app)
icon = ContextCompat.getDrawable(context, R.drawable.ic_open_external)
}

companion object {
private val log = LoggerFactory.getLogger(LaunchAppAction::class.java)
}

override fun prepare(data: ActionData) {
super.prepare(data)
data.getActivity() ?: run {
markInvisible()
return
}

visible = true

val projectManager = IProjectManager.getInstance()
enabled = projectManager.getAndroidAppModules().isNotEmpty()
}

override suspend fun execAction(data: ActionData) {
openApplicationModuleChooser(data) { app ->
val variant = app.getSelectedVariant()

log.debug("Selected variant: {}", variant?.name)

if (variant == null) {
flashError(R.string.err_selected_variant_not_found)
return@openApplicationModuleChooser
}

val applicationId = variant.mainArtifact.applicationId
if (applicationId == null) {
log.error("Unable to launch application. variant.mainArtifact.applicationId is null")
flashError(R.string.err_cannot_determine_package)
return@openApplicationModuleChooser
}

log.info("Launching application: {}", applicationId)

val activity = data.requireActivity()
activity.activityScope.launch {
IntentUtils.launchApp(
class LaunchAppAction(
context: Context,
override val order: Int,
) : EditorActivityAction() {
override val id: String = "ide.editor.launchInstalledApp"
override var requiresUIThread: Boolean = true

override fun retrieveTooltipTag(isReadOnlyContext: Boolean) = EDITOR_TOOLBAR_LAUNCH_APP

init {
label = context.getString(R.string.title_launch_app)
icon = ContextCompat.getDrawable(context, R.drawable.ic_open_external)
}

companion object {
private val log = LoggerFactory.getLogger(LaunchAppAction::class.java)
}

override fun prepare(data: ActionData) {
super.prepare(data)
data.getActivity() ?: run {
markInvisible()
return
}

visible = true

val projectManager = IProjectManager.getInstance()
enabled = projectManager.getAndroidAppModules().isNotEmpty()
}

override suspend fun execAction(data: ActionData) {
openApplicationModuleChooser(data) { app ->
val variant = app.getSelectedVariant()

log.debug("Selected variant: {}", variant?.name)

if (variant == null) {
flashError(R.string.err_selected_variant_not_found)
return@openApplicationModuleChooser
}

val applicationId = variant.mainArtifact.applicationId
if (applicationId == null) {
log.error("Unable to launch application. variant.mainArtifact.applicationId is null")
flashError(R.string.err_cannot_determine_package)
return@openApplicationModuleChooser
}

log.info("Launching application: {}", applicationId)

val projectDirPath = IProjectManager.getInstance().projectDirPath

val activity = data.requireActivity()
activity.activityScope.launch {
// Awaited so the app's first report cannot arrive before its row exists.
if (projectDirPath.isNotBlank()) {
GlobalContext
.get()
.get<DebuggerEndpointRepository>()
.recordLaunched(applicationId, File(projectDirPath))
}
IntentUtils.launchApp(
context = activity,
packageName = applicationId,
logError = false
logError = false,
)
}
}
}

override fun getShowAsActionFlags(data: ActionData): Int {
// prefer showing this in the overflow menu
return MenuItem.SHOW_AS_ACTION_IF_ROOM
}
}
}
}
}

override fun getShowAsActionFlags(data: ActionData): Int {
// prefer showing this in the overflow menu
return MenuItem.SHOW_AS_ACTION_IF_ROOM
}
}
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,7 @@
package com.itsaky.androidide.activities.editor

import android.content.Intent
import android.content.pm.PackageManager
import android.os.Bundle
import android.system.ErrnoException
import android.system.OsConstants
Expand Down Expand Up @@ -93,6 +94,7 @@ import com.itsaky.androidide.quickbuild.QuickBuildStatusTracker
import com.itsaky.androidide.quickbuild.QuickBuildWontStayUpRestart
import com.itsaky.androidide.quickbuild.quickBuildStatusBarUpdate
import com.itsaky.androidide.quickbuild.resolve
import com.itsaky.androidide.repositories.DebuggerEndpointRepository
import com.itsaky.androidide.repositories.PluginRepository
import com.itsaky.androidide.resources.R.string
import com.itsaky.androidide.search.replace.ReplaceCoordinator
Expand Down Expand Up @@ -183,6 +185,7 @@ abstract class ProjectHandlerActivity :
ReplaceHost {
protected val buildVariantsViewModel by viewModels<BuildVariantsViewModel>()
private val pluginRepository: PluginRepository by inject()
private val debuggerEndpointRepository: DebuggerEndpointRepository by inject()

protected var mSearchingProgress: ProgressSheet? = null
protected var mFindInProjectDialog: AlertDialog? = null
Expand Down Expand Up @@ -282,6 +285,15 @@ abstract class ProjectHandlerActivity :
const val STATE_KEY_SHOULD_INITIALIZE = "ide.editor.isInitializing"

private const val PLUGIN_SEARCH_TIMEOUT_SECONDS = 10L

private fun apkApplicationId(
packageManager: PackageManager,
apk: File,
): String? =
runCatching { packageManager.getPackageArchiveInfo(apk.absolutePath, 0)?.packageName }
.onFailure { logger.warn("Could not read the applicationId of {}", apk, it) }
.getOrNull()
?.takeIf { it.isNotBlank() }
}

abstract fun doCloseAll()
Expand Down Expand Up @@ -719,17 +731,33 @@ abstract class ProjectHandlerActivity :
*
* @param apk the built APK; parsed with the package manager, so it must exist on disk.
*/
private fun apkApplicationId(apk: File): String? =
runCatching { packageManager.getPackageArchiveInfo(apk.absolutePath, 0)?.packageName }
.onFailure { logger.warn("Could not read the applicationId of {}", apk, it) }
.getOrNull()
?.takeIf { it.isNotBlank() }
private fun apkApplicationId(apk: File): String? = apkApplicationId(packageManager, apk)

/**
* Notes the install of [apk] as the open project's for the SQLite debugger pairing (ADFA-7137), or null when no
* project is open. It runs on the install's IO thread before the session is committed, and
* InstallationResultReceiver pairs the app when that session succeeds. When the APK's application ID cannot be
* read, nothing is noted, and the app's next launch from the project pairs it. Captures no Activity: the install
* outlives a recreated one.
*/
private fun pendingInstallNote(apk: File): ((sessionId: Int) -> Unit)? {
val projectDirPath = IProjectManager.getInstance().projectDirPath
if (projectDirPath.isBlank()) return null
val projectDir = File(projectDirPath)
val repository = debuggerEndpointRepository
val packageManager = applicationContext.packageManager
return { sessionId ->
apkApplicationId(packageManager, apk)?.let { repository.notePendingInstall(sessionId, projectDir, it) }
}
}

private fun doInstallApk(state: BuildState.AwaitingInstall) {
apkInstallationViewModel.installApk(
context = this,
apk = state.apkFile,
launchInDebugMode = state.launchInDebugMode,
beforeCommit = pendingInstallNote(state.apkFile),
onCommitFailed = debuggerEndpointRepository::discardPendingInstall,
)

if (state.launchProfilerAfterInstall) {
Expand Down
15 changes: 15 additions & 0 deletions app/src/main/java/com/itsaky/androidide/di/AppModule.kt
Original file line number Diff line number Diff line change
Expand Up @@ -7,9 +7,11 @@ import com.itsaky.androidide.deeplink.PendingDeepLinkOpen
import com.itsaky.androidide.editor.language.outline.OutlineProvider
import com.itsaky.androidide.editor.language.outline.TreeSitterOutlineProvider
import com.itsaky.androidide.git.core.GitCredentialsManager
import com.itsaky.androidide.repositories.DebuggerEndpointRepository
import com.itsaky.androidide.repositories.RecentProjectRepository
import com.itsaky.androidide.repositories.RecentProjectRepositoryImpl
import com.itsaky.androidide.roomData.recentproject.RecentProjectRoomDatabase
import com.itsaky.androidide.sqlitedebugger.DebuggerEndpointAnnounce
import com.itsaky.androidide.viewmodel.CloneRepositoryViewModel
import com.itsaky.androidide.viewmodel.GitBottomSheetViewModel
import com.itsaky.androidide.viewmodel.MainViewModel
Expand Down Expand Up @@ -57,6 +59,19 @@ val coreModule =
get<RecentProjectRoomDatabase>().recentProjectDao()
}

single {
get<RecentProjectRoomDatabase>().debuggerEndpointDao()
}

single {
val context = androidContext()
DebuggerEndpointRepository(
get(),
get(named(APPLICATION_SCOPE)),
announce = { DebuggerEndpointAnnounce.send(context, it) },
)
}

single<RecentProjectRepository> {
RecentProjectRepositoryImpl(get())
}
Expand Down
Loading
Loading