website·Indexed 32 days ago
https://trapeze.devA native iOS and Android project management utility providing a configuration-driven tool and a Node.js-based API to automate project configuration. It supports native iOS, native Android, Flutter, Capacitor, and React Native projects, and is designed for use in CI/CD and Mobile DevOps automation workflows.
JsonFile class to load, set, and merge values within project JSON files. You can retrieve an existing file or create a new one via getProjectFile.// Get or create a JSON file
const jsonFile = ctx.project.android?.getProjectFile<JsonFile>(
filename,
(filename: string) => new JsonFile(filename, ctx.project.vfs, ctx.project),
);
// Load the file into memory
await jsonFile.load();
// Set specific values
jsonFile.set({
field: 'value'
});
// Merge values into the existing structure
jsonFile.merge({
field: {
field2: 'value'
}
});@trapezedev/configure package. When targeting a standalone iOS project, operations for other platforms (such as Android) are ignored.# config.yaml
platforms:
ios:
targets:
App:
version: 16.4npm install @trapezedev/configure
npx trapeze run config.yamlTrapeze allows modification of project files relative to the iOS project root:
set to override an element or merge to combine values.attrs (update attributes), merge (merge XML tree), inject (inject XML tree), delete (XPath deletion), and deleteAttributes.set to define build configuration values.platforms:
ios:
targets:
App:
json:
- file: google-services.json
merge:
data:
field: "MY_FIELD"
xml:
- file: file.xml
target: entries/field
merge: |
<field>
<string>Value</string>
</field>
xcconfig:
- file: App/Config.xcconfig
set:
"PRODUCT_NAME": "$(NAME)"@trapezedev/configure package.# config.yaml
platforms:
android:
manifest:
- file: AndroidManifest.xml
target: manifest/application
inject:
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
ios:
targets:
App:
version: 16.4npm install @trapezedev/configure
npx trapeze run config.yamlCI_BUILD_NUMBER) to the buildNumber for iOS and versionCode for Android in your Trapeze configuration.vars:
CI_BUILD_NUMBER:
default: 1
platforms:
ios:
buildNumber: $CI_BUILD_NUMBER
android:
versionCode: $CI_BUILD_NUMBER# Example installation and configuration flow
npm install my-capacitor-plugin
npx @trapezedev/configure run node_modules/my-capacitor-plugin/install.yamlcopyToResources method supports passing a local file path or a URL as the source to fetch remote files.// Add a resource to a directory (e.g., 'raw') with name and contents
await project.android?.addResource('raw', 'test.json', `{}`);
// Copy an existing file or fetch from URL to resources
await project.android?.copyToResources('drawable', 'icon.png', source);
// Load an existing resource
const data = await project.android?.getResource('raw', 'test.json');@trapezedev/project package. Additionally, ensure that the dom library is enabled in the lib section of your tsconfig.json under compilerOptions.npm install @trapezedev/projectThe Trapeze Configuration tool allows developers to modify mobile projects by defining operations in a YAML configuration file. It leverages the Project API internally and supports environment variables for dynamic configuration. Key capabilities include:
The Trapeze Configuration tool allows developers to modify mobile projects using a YAML configuration file. It leverages the Project API internally and supports environment variables for dynamic configuration. Key capabilities include: