"'newLayer' is an unknown keyword argument" error when creating GeoPackage file with one layer (or more) named different from file name using PyQGIS

Question

I want to create a GeoPackage file using PyQGIS (for example database.gpkg) with one layer (named "myLayer") not having any QgsVectorLayer at all.

I've tried this:

from qgis.core import QgsVectorFileWriter

writer = QgsVectorFileWriter(fileName, 'UTF-8', layerFields, QgsWkbTypes.Unknown, QgsProject.instance().crs(), 'GPKG', newLayer='myLayer')

but got an error:

('newLayer' is an unknown keyword argument)

I can't use writeAsVectorFormatV2 because I need to create a file first and then add it to QGIS.

Answer 1

Finally, I found the solution. This example creates a GeoPackage file with one geometryless layer without fields. The last line is necessary for the completion of file creation.

from qgis.core import QgsVectorFileWriter, QgsCoordinateTransformContext

file_path = 'd:\\test.gpkg'
options = QgsVectorFileWriter.SaveVectorOptions()
options.layerName = 'my_layer'
transform_context = QgsCoordinateTransformContext()
writer = QgsVectorFileWriter.create(file_path, QgsFields(), QgsWkbTypes.Unknown, QgsProject.instance().crs(), transform_context, options)
del writer