Fragmentos de Android con « Qt Quick » para Android

Puedes incluir un QtQuickView en un diseño de interfaz de usuario de Android utilizando un objeto basado en ViewGroup. En este caso, utilizaremos un FrameLayout.

Si no estás familiarizado con la API de QtQuickView, lee su documentación antes de continuar con este tutorial.

Antes de continuar, merece la pena echar un vistazo al curso de Qt Academy: «Qt Academy: Incorporación de contenido 3D de Qt Quick en una aplicación de Android».

Para empezar, crea un nuevo proyecto en Android Studio utilizando la plantilla « Bottom Navigation Views Activity ».

  1. Localiza el fragmento o la actividad en la que quieres que se vea tu QtQuickView. Aquí utilizamos HomeFragment y fragment_home.xml.
  2. En « fragment_home.xml », crea un «FrameLayout» y configura su « id » tal y como se muestra a continuación.
    <FrameLayout
    android:id="@+id/homeQmlFrame"
    android:layout_width="0dp"
    android:layout_height="0dp"
    app:layout_constraintTop_toTopOf="parent"
    app:layout_constraintStart_toStartOf="parent"
    app:layout_constraintEnd_toEndOf="parent"
    app:layout_constraintHeight_percent="0.8"/>

    Anota este identificador, ya que será necesario hacer referencia a él en HomeFragment al vincular el diseño.

  3. Dentro de HomeFragment.kt, añade una instrucción de importación para FrameLayout:
    import android.widget.FrameLayout
  4. Añade las importaciones para tu tipo QtQuickView y Screen01 QML y decláralas dentro de la clase:
    import org.qtproject.qt.android.QtQuickView
    import org.qtproject.example.RoboApp.RoboContent.Screen01
    
    class HomeFragment : Fragment() {
    
    private var binding: FragmentHomeBinding? = null
    private lateinit var homeQmlContent: Screen01
    private lateinit var homeQtQuickView: QtQuickView
  5. Asigna tu QtQuickView, proporcionándole la instancia de Activity mediante requireActivity()
    homeQtQuickView = QtQuickView(requireActivity())
    homeQmlContent = Screen01()
  6. Inicializa los parámetros de diseño; si creas vistas mediante código, añades vistas dinámicamente o las modificas en tiempo de ejecución. De lo contrario, puedes saltarte esta sección y no es necesario que utilices ` params ` con ` addView()`.
    val params = FrameLayout.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT,
                                          ViewGroup.LayoutParams.MATCH_PARENT)
  7. Añade tu vista al diseño, ya sea con:
    1. Utilizando el enlace de vistas dentro de ` onCreateView()`: primero comprueba que el enlace de vistas esté habilitado añadiendo la sección ` buildFeature ` en la sección `android` del archivo `build.gradle.kts` de tu aplicación:
      buildFeatures {
          viewBinding = true
      }

      A continuación, añade lo siguiente en onCreateView():

      binding = FragmentHomeBinding.inflate( inflater, container, false)
      homeQtQuickView.loadContent(homeQmlContent)
      
      val root: View = binding.root
      binding.homeQmlFrame.addView(homeQtQuickView, params)
      ...
      return root
    2. Uso de ` findViewById() ` dentro de ` onCreate()`:
      val qtFrame = findViewById(R.id.qtFrame)
      qmlFrame.addView(m_quickView, params)
      m_quickView.loadContent(homeQmlContent)

      Consulta ejemplos de uso de otros archivos «Qt Quick » para Android.

El contenido de tu « Qt Quick » aparecerá ahora en tu fragmento de inicio.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.