Compare commits
	
		
			1 Commits
		
	
	
		
			main
			...
			3c2e071477
		
	
	| Author | SHA1 | Date | |
|---|---|---|---|
| 3c2e071477 | 
| @@ -1,33 +1,22 @@ | ||||
| on: | ||||
|   workflow_call: | ||||
|     inputs: | ||||
|       build_type: | ||||
|         description: 'Release type (release, beta)' | ||||
|         required: true | ||||
|         type: string | ||||
|       build_name: | ||||
|         description: 'Build name' | ||||
|         required: true | ||||
|         type: string | ||||
|     secrets: | ||||
|       ANDROID_SECRET_PROPERTIES_BASE64: | ||||
|         required: true | ||||
|       ANDROID_GOOGLE_PLAY_JSON_BASE64: | ||||
|         required: true | ||||
|       ANDROID_KEYSTORE_BASE64: | ||||
|         required: true | ||||
|       ANDROID_GOOGLE_MAPS_API_KEY: | ||||
|         required: true | ||||
|   pull_request: | ||||
|     branches: | ||||
|       - main | ||||
|     # paths: | ||||
|     #   - frontend/** | ||||
| 
 | ||||
| name: Build and release android appbundle to specfied track | ||||
| 
 | ||||
| name: Build and release debug APK | ||||
| 
 | ||||
| defaults: | ||||
|   run: | ||||
|     working-directory: frontend/android | ||||
| 
 | ||||
| 
 | ||||
| jobs: | ||||
|   build: | ||||
|     runs-on: macos-14 | ||||
|     name: Build APK | ||||
|     runs-on: macos | ||||
|     env: | ||||
|       # $BUNDLE_GEMFILE must be set at the job level, so it is set for all steps | ||||
|       BUNDLE_GEMFILE: ${{ gitea.workspace }}/frontend/android/Gemfile | ||||
| @@ -50,7 +39,6 @@ jobs: | ||||
|       with: | ||||
|         channel: stable | ||||
|         flutter-version-file: ${{ gitea.workspace }}/frontend/pubspec.yaml | ||||
|         architecture: x64 | ||||
|         cache: true | ||||
| 
 | ||||
|     - name: Install dependencies and clean up | ||||
| @@ -64,6 +52,14 @@ jobs: | ||||
|         ruby-version: 3.3 | ||||
|         bundler-cache: true # runs 'bundle install' and caches installed gems automatically | ||||
| 
 | ||||
|     - name: Infer version number from git tag | ||||
|       id: version | ||||
|       env:  | ||||
|         REF_NAME: ${{ gitea.ref_name }} | ||||
|       run: | ||||
|         # remove the 'v' prefix from the tag name | ||||
|         echo "BUILD_NAME=${REF_NAME//v}" >> $GITHUB_ENV | ||||
| 
 | ||||
|     - name: Add required secret files | ||||
|       run: | | ||||
|         echo "${{ secrets.ANDROID_SECRET_PROPERTIES_BASE64 }}" | base64 -d > secrets.properties | ||||
| @@ -71,8 +67,8 @@ jobs: | ||||
|         echo "${{ secrets.ANDROID_KEYSTORE_BASE64 }}" | base64 -d > release.keystore | ||||
| 
 | ||||
|     - name: Run fastlane lane | ||||
|       run: bundle exec fastlane deploy_${{ inputs.build_type }} | ||||
|       run: bundle exec fastlane deploy_beta | ||||
|       env: | ||||
|         BUILD_NUMBER: ${{ gitea.run_number }} | ||||
|         BUILD_NAME: ${{ inputs.build_name }} | ||||
|         # BUILD_NAME is implicitly available | ||||
|         ANDROID_GOOGLE_MAPS_API_KEY: ${{ secrets.ANDROID_GOOGLE_MAPS_API_KEY }} | ||||
| @@ -1,29 +1,11 @@ | ||||
| on: | ||||
|   workflow_call: | ||||
|     inputs: | ||||
|       build_type: | ||||
|         description: 'Release type (release, beta)' | ||||
|         required: true | ||||
|         type: string | ||||
|       build_name: | ||||
|         description: 'Build name' | ||||
|         required: true | ||||
|         type: string | ||||
|     secrets: | ||||
|       IOS_ASC_KEY_ID: | ||||
|         required: true | ||||
|       IOS_ASC_ISSUER_ID: | ||||
|         required: true | ||||
|       IOS_ASC_KEY: | ||||
|         required: true | ||||
|       IOS_MATCH_REPO_SSH_KEY_BASE64: | ||||
|         required: true | ||||
|       IOS_MATCH_PASSWORD: | ||||
|         required: true | ||||
|       IOS_GOOGLE_MAPS_API_KEY: | ||||
|         required: true | ||||
|   pull_request: | ||||
|     branches: | ||||
|       - main | ||||
|     # paths: | ||||
|     #   - frontend/** | ||||
| 
 | ||||
| name: Build and release ipa to specified track | ||||
| name: Build and release debugging app to ios testflight | ||||
| 
 | ||||
| defaults: | ||||
|   run: | ||||
| @@ -31,7 +13,7 @@ defaults: | ||||
| 
 | ||||
| jobs: | ||||
|   build: | ||||
|     runs-on: macos-14 | ||||
|     runs-on: macos | ||||
|     env: | ||||
|       # $BUNDLE_GEMFILE must be set at the job level, so it is set for all steps | ||||
|       BUNDLE_GEMFILE: ${{ gitea.workspace }}/frontend/ios/Gemfile | ||||
| @@ -44,25 +26,28 @@ jobs: | ||||
|         with: | ||||
|           channel: stable | ||||
|           flutter-version-file: ${{ gitea.workspace }}/frontend/pubspec.yaml | ||||
|           architecture: x64 | ||||
|           cache: true | ||||
| 
 | ||||
|       - name: Install dependencies and clean up | ||||
|         run: | | ||||
|           flutter pub get | ||||
|           bundle exec pod install | ||||
|           flutter clean | ||||
|           bundle exec pod cache clean --all | ||||
| 
 | ||||
|       - name: Set up ruby env | ||||
|         uses: https://github.com/ruby/setup-ruby@v1 | ||||
|         with: | ||||
|           ruby-version: 3.3 | ||||
|           bundler-cache: true # runs 'bundle install' and caches installed gems automatically | ||||
| 
 | ||||
|       - uses: GuillaumeFalourd/setup-rsync@v1.2 | ||||
|         # rsync is required by the google maps ios tools | ||||
| 
 | ||||
|       - name: Install dependencies and clean up | ||||
|         run: | | ||||
|           flutter pub get | ||||
|           flutter precache --ios | ||||
|           bundle exec pod install --allow-root | ||||
|           flutter clean | ||||
|           bundle exec pod cache clean --all --allow-root | ||||
|       - name: Infer version number from git tag | ||||
|         id: version | ||||
|         env:  | ||||
|           REF_NAME: ${{ gitea.ref_name }} | ||||
|         run: | ||||
|           # remove the 'v' prefix from the tag name | ||||
|           echo "BUILD_NAME=${REF_NAME//v}" >> $GITHUB_ENV | ||||
| 
 | ||||
|       - name: Setup SSH key for match git repo | ||||
|         # and mark the host as known | ||||
| @@ -73,16 +58,12 @@ jobs: | ||||
|         env: | ||||
|           MATCH_REPO_SSH_KEY: ${{ secrets.IOS_MATCH_REPO_SSH_KEY_BASE64 }} | ||||
| 
 | ||||
|       - name: Replace API Key from secret | ||||
|         # on a macOS runner, sed requires a replacement suffix after the -i flag | ||||
|         run: | | ||||
|           sed -i '' -e "s/IOS_GOOGLE_MAPS_API_KEY/${{ secrets.IOS_GOOGLE_MAPS_API_KEY }}/g" Runner/AppDelegate.swift | ||||
| 
 | ||||
|       - name: Run fastlane lane | ||||
|         run: bundle exec fastlane deploy_${{ inputs.build_type }} | ||||
|         run: bundle exec fastlane deploy_beta | ||||
|         env: | ||||
|           BUILD_NUMBER: ${{ gitea.run_number }} | ||||
|           BUILD_NAME: ${{ inputs.build_name }} | ||||
|           # BUILD_NAME is implicitly available | ||||
|           GOOGLE_MAPS_API_KEY: ${{ secrets.GOOGLE_MAPS_API_KEY }} | ||||
|           IOS_ASC_KEY_ID: ${{ secrets.IOS_ASC_KEY_ID }} | ||||
|           IOS_ASC_ISSUER_ID: ${{ secrets.IOS_ASC_ISSUER_ID }} | ||||
|           IOS_ASC_KEY: ${{ secrets.IOS_ASC_KEY }} | ||||
| @@ -1,59 +0,0 @@ | ||||
| on: | ||||
|   pull_request: | ||||
|     branches: | ||||
|       - main | ||||
|     paths: | ||||
|       - frontend/** | ||||
|  | ||||
| name: Build and release apps to beta track | ||||
|  | ||||
| jobs: | ||||
|   get-version: | ||||
|     name: Get version | ||||
|     runs-on: macos | ||||
|     steps: | ||||
|       - uses: https://gitea.com/actions/checkout@v4 | ||||
|  | ||||
|       - name: Fetch tags from main branch | ||||
|         # since this workflow is triggered by a pull request, we want to match the latest tag of the main branch | ||||
|         id: version | ||||
|         run: | | ||||
|           git fetch origin main --tags | ||||
|           LATEST_TAG=$(git describe --tags $(git rev-list --tags --max-count=1)) | ||||
|           # remove the 'v' prefix from the tag name | ||||
|           echo "BUILD_NAME=${LATEST_TAG//v}" >> $GITHUB_OUTPUT | ||||
|  | ||||
|       - name: Output the version that is being used | ||||
|         run: | | ||||
|           echo "Building for version ${{ steps.version.outputs.BUILD_NAME }}" | ||||
|  | ||||
|     outputs: | ||||
|       build_name: ${{ steps.version.outputs.BUILD_NAME }} | ||||
|  | ||||
|   build-android: | ||||
|     name: Build and upload android app | ||||
|     uses: ./.gitea/workflows/workflow_build-app-android.yaml | ||||
|     with: | ||||
|       build_type: beta | ||||
|       build_name: ${{ needs.get-version.outputs.build_name }} | ||||
|     secrets: | ||||
|       ANDROID_SECRET_PROPERTIES_BASE64: ${{ secrets.ANDROID_SECRET_PROPERTIES_BASE64 }} | ||||
|       ANDROID_GOOGLE_PLAY_JSON_BASE64: ${{ secrets.ANDROID_GOOGLE_PLAY_JSON_BASE64 }} | ||||
|       ANDROID_KEYSTORE_BASE64: ${{ secrets.ANDROID_KEYSTORE_BASE64 }} | ||||
|       ANDROID_GOOGLE_MAPS_API_KEY: ${{ secrets.ANDROID_GOOGLE_MAPS_API_KEY }} | ||||
|     needs: get-version | ||||
|  | ||||
|   build-ios: | ||||
|     name: Build and upload ios app | ||||
|     uses: ./.gitea/workflows/workflow_build-app-ios.yaml | ||||
|     with: | ||||
|       build_type: beta | ||||
|       build_name: ${{ needs.get-version.outputs.build_name }} | ||||
|     secrets: | ||||
|       IOS_ASC_KEY_ID: ${{ secrets.IOS_ASC_KEY_ID }} | ||||
|       IOS_ASC_ISSUER_ID: ${{ secrets.IOS_ASC_ISSUER_ID }} | ||||
|       IOS_ASC_KEY: ${{ secrets.IOS_ASC_KEY }} | ||||
|       IOS_MATCH_REPO_SSH_KEY_BASE64: ${{ secrets.IOS_MATCH_REPO_SSH_KEY_BASE64 }} | ||||
|       IOS_MATCH_PASSWORD: ${{ secrets.IOS_MATCH_PASSWORD }} | ||||
|       IOS_GOOGLE_MAPS_API_KEY: ${{ secrets.IOS_GOOGLE_MAPS_API_KEY }} | ||||
|     needs: build-android # technically not needed, but this prevents the builds from running in parallel | ||||
| @@ -1,56 +0,0 @@ | ||||
| on: | ||||
|   push: | ||||
|     tags: | ||||
|       - v* | ||||
|  | ||||
| name: Build and release apps to production track | ||||
|  | ||||
| jobs: | ||||
|   get-version: | ||||
|     name: Get version | ||||
|     runs-on: macos | ||||
|     steps: | ||||
|       - uses: https://gitea.com/actions/checkout@v4 | ||||
|  | ||||
|       - name: Get version from git tag | ||||
|         id: version | ||||
|         env:  | ||||
|           REF_NAME: ${{ gitea.ref_name }} | ||||
|         # remove the 'v' prefix from the tag name | ||||
|         run: | | ||||
|           echo "BUILD_NAME=${REF_NAME//v}" >> $GITHUB_OUTPUT | ||||
|  | ||||
|       - name: Output the version that is being used | ||||
|         run: | | ||||
|           echo "Building for version ${{ steps.version.outputs.BUILD_NAME }}" | ||||
|  | ||||
|     outputs: | ||||
|       build_name: ${{ steps.version.outputs.BUILD_NAME }} | ||||
|  | ||||
|   build-android: | ||||
|     name: Build and upload android app | ||||
|     uses: ./.gitea/workflows/workflow_build-app-android.yaml | ||||
|     with: | ||||
|       build_type: release | ||||
|       build_name: ${{ needs.get-version.outputs.build_name }} | ||||
|     secrets: | ||||
|       ANDROID_SECRET_PROPERTIES_BASE64: ${{ secrets.ANDROID_SECRET_PROPERTIES_BASE64 }} | ||||
|       ANDROID_GOOGLE_PLAY_JSON_BASE64: ${{ secrets.ANDROID_GOOGLE_PLAY_JSON_BASE64 }} | ||||
|       ANDROID_KEYSTORE_BASE64: ${{ secrets.ANDROID_KEYSTORE_BASE64 }} | ||||
|       ANDROID_GOOGLE_MAPS_API_KEY: ${{ secrets.ANDROID_GOOGLE_MAPS_API_KEY }} | ||||
|     needs: get-version | ||||
|  | ||||
|   build-ios: | ||||
|     name: Build and upload ios app | ||||
|     uses: ./.gitea/workflows/workflow_build-app-ios.yaml | ||||
|     with: | ||||
|       build_type: release | ||||
|       build_name: ${{ needs.get-version.outputs.build_name }} | ||||
|     secrets: | ||||
|       IOS_ASC_KEY_ID: ${{ secrets.IOS_ASC_KEY_ID }} | ||||
|       IOS_ASC_ISSUER_ID: ${{ secrets.IOS_ASC_ISSUER_ID }} | ||||
|       IOS_ASC_KEY: ${{ secrets.IOS_ASC_KEY }} | ||||
|       IOS_MATCH_REPO_SSH_KEY_BASE64: ${{ secrets.IOS_MATCH_REPO_SSH_KEY_BASE64 }} | ||||
|       IOS_MATCH_PASSWORD: ${{ secrets.IOS_MATCH_PASSWORD }} | ||||
|       IOS_GOOGLE_MAPS_API_KEY: ${{ secrets.IOS_GOOGLE_MAPS_API_KEY }} | ||||
|     needs: build-android # technically not needed, but this prevents the builds from running in parallel | ||||
							
								
								
									
										59
									
								
								frontend/.github/workflows/build_app_android.yaml
									
									
									
									
										vendored
									
									
										Normal file
									
								
							
							
						
						| @@ -0,0 +1,59 @@ | ||||
| on: | ||||
|   push: | ||||
|     tags: | ||||
|       - 'v*' | ||||
|  | ||||
| jobs: | ||||
|   build: | ||||
|     runs-on: macos-latest | ||||
|     steps: | ||||
|       - uses: actions/checkout@v4 | ||||
|  | ||||
|       - name: Set up ruby env | ||||
|         uses: ruby/setup-ruby@v1 | ||||
|         with: | ||||
|           ruby-version: 3.2.1 | ||||
|           bundler-cache: true | ||||
|  | ||||
|       - name: Setup java for android build | ||||
|         uses: actions/setup-java@v4 | ||||
|         with: | ||||
|           java-version: '17' | ||||
|           distribution: 'zulu' | ||||
|  | ||||
|       - name: Setup android SDK | ||||
|         uses: android-actions/setup-android@v3 | ||||
|        | ||||
|       - name: Install Flutter | ||||
|         uses: subosito/flutter-action@v2 | ||||
|         with: | ||||
|           channel: stable | ||||
|           flutter-version: 3.22.0 | ||||
|           cache: true | ||||
|  | ||||
|       - name: Infer version number from git tag | ||||
|         id: version | ||||
|         env:  | ||||
|           REF_NAME: ${{ github.ref_name }} | ||||
|         run: | ||||
|           # remove the 'v' prefix from the tag name | ||||
|           echo "BUILD_NAME=${REF_NAME//v}" >> $GITHUB_ENV | ||||
|  | ||||
|       - name: Put selected secrets into files | ||||
|         run: | | ||||
|           echo "${{ secrets.ANDROID_SECRET_PROPERTIES_BASE64 }}" | base64 -d > secrets.properties | ||||
|           echo "${{ secrets.ANDROID_GOOGLE_PLAY_JSON_BASE64 }}" | base64 -d > google-key.json | ||||
|           echo "${{ secrets.ANDROID_KEYSTORE_BASE64 }}" | base64 -d > release.keystore | ||||
|         working-directory: android | ||||
|  | ||||
|       - name: Install fastlane | ||||
|         run: bundle install | ||||
|         working-directory: android | ||||
|  | ||||
|       - name: Run fastlane lane | ||||
|         run: bundle exec fastlane deploy_release | ||||
|         working-directory: android | ||||
|         env: | ||||
|           BUILD_NUMBER: ${{ github.run_number }} | ||||
|           # BUILD_NAME is implicitly available | ||||
|           GOOGLE_MAPS_API_KEY: ${{ secrets.GOOGLE_MAPS_API_KEY }} | ||||
							
								
								
									
										64
									
								
								frontend/.github/workflows/build_app_ios.yaml
									
									
									
									
										vendored
									
									
										Normal file
									
								
							
							
						
						| @@ -0,0 +1,64 @@ | ||||
| on: | ||||
|   push: | ||||
|     tags: | ||||
|       - 'v*' | ||||
|  | ||||
| jobs: | ||||
|   build: | ||||
|     runs-on: macos-latest | ||||
|     env: | ||||
|       # $BUNDLE_GEMFILE must be set at the job level, so it is set for all steps | ||||
|       BUNDLE_GEMFILE: ${{ github.workspace }}/ios/Gemfile | ||||
|     steps: | ||||
|       - uses: actions/checkout@v4 | ||||
|  | ||||
|       - name: Set up ruby env | ||||
|         uses: ruby/setup-ruby@v1 | ||||
|         with: | ||||
|           ruby-version: 3.3 | ||||
|           bundler-cache: true # runs 'bundle install' and caches installed gems automatically | ||||
|  | ||||
|       - name: Install Flutter | ||||
|         uses: subosito/flutter-action@v2 | ||||
|         with: | ||||
|           channel: stable | ||||
|           flutter-version: 3.22.0 | ||||
|           cache: true | ||||
|  | ||||
|       - name: Infer version number from git tag | ||||
|         id: version | ||||
|         env:  | ||||
|           REF_NAME: ${{ github.ref_name }} | ||||
|         run: | ||||
|           # remove the 'v' prefix from the tag name | ||||
|           echo "BUILD_NAME=${REF_NAME//v}" >> $GITHUB_ENV | ||||
|  | ||||
|       - name: Setup SSH key for match git repo | ||||
|         # and mark the host as known | ||||
|         run: | | ||||
|           echo $MATCH_REPO_SSH_KEY | base64 --decode > ~/.ssh/id_rsa | ||||
|           chmod 600 ~/.ssh/id_rsa | ||||
|           ssh-keyscan -p 2222 git.kluster.moll.re > ~/.ssh/known_hosts | ||||
|         env: | ||||
|           MATCH_REPO_SSH_KEY: ${{ secrets.IOS_MATCH_REPO_SSH_KEY_BASE64 }} | ||||
|  | ||||
|       - name: Install dependencies and clean up | ||||
|         run: | | ||||
|           flutter pub get | ||||
|           bundle exec pod install | ||||
|           flutter clean | ||||
|           bundle exec pod cache clean --all | ||||
|         working-directory: ios | ||||
|  | ||||
|       - name: Run fastlane lane | ||||
|         run: bundle exec fastlane deploy_release --verbose | ||||
|         working-directory: ios | ||||
|         env: | ||||
|           BUILD_NUMBER: ${{ github.run_number }} | ||||
|           # BUILD_NAME is implicitly available | ||||
|           GOOGLE_MAPS_API_KEY: ${{ secrets.GOOGLE_MAPS_API_KEY }} | ||||
|           IOS_ASC_KEY_ID: ${{ secrets.IOS_ASC_KEY_ID }} | ||||
|           IOS_ASC_ISSUER_ID: ${{ secrets.IOS_ASC_ISSUER_ID }} | ||||
|           IOS_ASC_KEY: ${{ secrets.IOS_ASC_KEY }} | ||||
|           MATCH_PASSWORD: ${{ secrets.IOS_MATCH_PASSWORD }} | ||||
|           IOS_GOOGLE_MAPS_API_KEY: ${{ secrets.IOS_GOOGLE_MAPS_API_KEY }} | ||||
| @@ -4,7 +4,7 @@ | ||||
| # This file should be version controlled and should not be manually edited. | ||||
|  | ||||
| version: | ||||
|   revision: "09de023485e95e6d1225c2baa44b8feb85e0d45f" | ||||
|   revision: "54e66469a933b60ddf175f858f82eaeb97e48c8d" | ||||
|   channel: "stable" | ||||
|  | ||||
| project_type: app | ||||
| @@ -13,11 +13,26 @@ project_type: app | ||||
| migration: | ||||
|   platforms: | ||||
|     - platform: root | ||||
|       create_revision: 09de023485e95e6d1225c2baa44b8feb85e0d45f | ||||
|       base_revision: 09de023485e95e6d1225c2baa44b8feb85e0d45f | ||||
|       create_revision: 54e66469a933b60ddf175f858f82eaeb97e48c8d | ||||
|       base_revision: 54e66469a933b60ddf175f858f82eaeb97e48c8d | ||||
|     - platform: android | ||||
|       create_revision: 54e66469a933b60ddf175f858f82eaeb97e48c8d | ||||
|       base_revision: 54e66469a933b60ddf175f858f82eaeb97e48c8d | ||||
|     - platform: ios | ||||
|       create_revision: 54e66469a933b60ddf175f858f82eaeb97e48c8d | ||||
|       base_revision: 54e66469a933b60ddf175f858f82eaeb97e48c8d | ||||
|     - platform: linux | ||||
|       create_revision: 09de023485e95e6d1225c2baa44b8feb85e0d45f | ||||
|       base_revision: 09de023485e95e6d1225c2baa44b8feb85e0d45f | ||||
|       create_revision: 54e66469a933b60ddf175f858f82eaeb97e48c8d | ||||
|       base_revision: 54e66469a933b60ddf175f858f82eaeb97e48c8d | ||||
|     - platform: macos | ||||
|       create_revision: 54e66469a933b60ddf175f858f82eaeb97e48c8d | ||||
|       base_revision: 54e66469a933b60ddf175f858f82eaeb97e48c8d | ||||
|     - platform: web | ||||
|       create_revision: 54e66469a933b60ddf175f858f82eaeb97e48c8d | ||||
|       base_revision: 54e66469a933b60ddf175f858f82eaeb97e48c8d | ||||
|     - platform: windows | ||||
|       create_revision: 54e66469a933b60ddf175f858f82eaeb97e48c8d | ||||
|       base_revision: 54e66469a933b60ddf175f858f82eaeb97e48c8d | ||||
|  | ||||
|   # User provided section | ||||
|  | ||||
|   | ||||
| @@ -17,17 +17,7 @@ flutter pub get | ||||
| ``` | ||||
|  | ||||
| ## Development | ||||
| ### TODO | ||||
|  | ||||
| ## Deployment and metadata | ||||
| ### Deploying a new version | ||||
| To truly deploy a new version of the application, i.e. to the official app stores, a special CI step is required. This listens for new tags. To create a new tag position yourself on the main branch and run | ||||
| ```bash | ||||
| git tag -a v<name> -m "Release <name>" | ||||
| git push origin v<name> | ||||
| ``` | ||||
| We adhere to the [Semantic Versioning](https://semver.org/) standard, so the tag should be of the form `v0.1.8` for example.  | ||||
|  | ||||
| ### ... | ||||
| ### Icons and logos | ||||
| The application uses a custom launcher icon and splash screen. These are managed platform-independently using the `flutter_launcher_icons` package. | ||||
|  | ||||
| @@ -35,10 +25,14 @@ To update the icons, change the `flutter_launcher_icons.yaml` configuration file | ||||
| ```bash | ||||
| dart run flutter_launcher_icons | ||||
| ``` | ||||
| ### Other metadata | ||||
| Fastlane provides mechanisms to update the metadata of the application. This includes the name, description, screenshots, etc. The metadata is stored in the `fastlane/metadata` directory of both the `android`and the `ios` version of the application. Both versions have different structures but **they should be kept in sync**. For more information see the [fastlane documentation](https://docs.fastlane.tools/): | ||||
| - https://docs.fastlane.tools/actions/deliver/ | ||||
| - https://docs.fastlane.tools/actions/supply/ | ||||
|  | ||||
| ### Deploying a new version | ||||
| To truly deploy a new version of the application, i.e. to the official app stores, a special CI step is required. This listens for new tags. To create a new tag position yourself on the main branch and run | ||||
| ```bash | ||||
| git tag -a v<name> -m "Release <name>" | ||||
| git push origin v<name> | ||||
| ``` | ||||
| We adhere to the [Semantic Versioning](https://semver.org/) standard, so the tag should be of the form `v0.1.8` for example.  | ||||
|  | ||||
|  | ||||
| ## Fastlane - in depth | ||||
| @@ -52,17 +46,16 @@ bundle exec fastlane <lane> | ||||
| ``` | ||||
| This is reused in the CI/CD pipeline to automate the deployment process. | ||||
|  | ||||
| Secrets used by fastlane are stored on hashicorp vault and are fetched by the CI/CD pipeline. See below. | ||||
|  | ||||
| ## Secrets | ||||
| These are used by the CI/CD pipeline to deploy the application. | ||||
| These are mostly used by the CI/CD pipeline to deploy the application. The main usage for github actions is documented under [https://github.com/hashicorp/vault-action](https://github.com/hashicorp/vault-action). | ||||
|  | ||||
| **Platform-specific secrets** are used by the CI/CD pipeline to deploy to the respective app stores. | ||||
| - `ANDROID_GOOGLE_MAPS_API_KEY` is used to authenticate with the Google Maps API and is scoped to the android platform | ||||
| - `GOOGLE_MAPS_API_KEY` is used to authenticate with the Google Maps API and is scoped to the android platform | ||||
| - `ANDROID_KEYSTORE` is used to sign the android apk | ||||
| - `ANDROID_GOOGLE_KEY` is used to authenticate with the Google Play Store api | ||||
| - `IOS_GOOGLE_MAPS_API_KEY` is used to authenticate with the Google Maps API and is scoped to the ios platform | ||||
| - `IOS_ASC_ISSUER_ID` is used to authenticate with the App Store Connect API | ||||
| - `IOS_ASC_KEY` as well | ||||
| - `IOS_ASC_KEY_ID` as well | ||||
| - `IOS_MATCH_PASSWORD` is used by fastlane match to download the certificates | ||||
| - `IOS_MATCH_REPO_SSH_KEY_BASE64` is used to authenticate with the git repository where the certificates are stored | ||||
| - `IOS_GOOGLE_...` | ||||
| - `IOS_GOOGLE_...` | ||||
| - `IOS_GOOGLE_...` | ||||
| @@ -77,7 +77,7 @@ android { | ||||
|         versionCode flutterVersionCode.toInteger() | ||||
|         versionName flutterVersionName | ||||
|         // // Placeholders of keys that are replaced by the build system. | ||||
|         manifestPlaceholders += ['MAPS_API_KEY': System.getenv('ANDROID_GOOGLE_MAPS_API_KEY')] | ||||
|         manifestPlaceholders += ['MAPS_API_KEY': System.getenv('GOOGLE_MAPS_API_KEY')] | ||||
|  | ||||
|     } | ||||
|  | ||||
|   | ||||
| @@ -3,7 +3,7 @@ default_platform(:android) | ||||
| platform :android do | ||||
|  | ||||
|   desc "Deploy a new version to closed testing (play store)" | ||||
|   lane :deploy_beta do | ||||
|   lane :deploy_testing do | ||||
|     build_name = ENV["BUILD_NAME"] | ||||
|     build_number = ENV["BUILD_NUMBER"] | ||||
|  | ||||
| @@ -17,8 +17,7 @@ platform :android do | ||||
|       ) | ||||
|      | ||||
|     upload_to_play_store( | ||||
|       track: 'beta', | ||||
|       # upload aab files intstead | ||||
|       track: 'alpha', | ||||
|       skip_upload_apk: true, | ||||
|       skip_upload_changelogs: true, | ||||
|       aab: "../build/app/outputs/bundle/release/app-release.aab", | ||||
| @@ -48,7 +47,6 @@ platform :android do | ||||
|       skip_upload_apk: true, | ||||
|       skip_upload_changelogs: true, | ||||
|       aab: "../build/app/outputs/bundle/release/app-release.aab", | ||||
|       metadata_path: "fastlane/metadata", | ||||
|       ) | ||||
|   end | ||||
| end | ||||
|   | ||||
| @@ -0,0 +1,7 @@ | ||||
| AnyWay - plan city trips your way | ||||
|  | ||||
| AnyWay is a mobile application that helps users plan city trips. The app allows users to specify their preferences and constraints, and then generates a personalized itinerary for them. The planning follows some guiding principles: | ||||
| - **Personalization**:The user's preferences should be reflected in the choice of destinations. | ||||
| - **Efficiency**:The itinerary should be optimized for the user's constraints. | ||||
| - **Flexibility**: We aknowledge that tourism is a dynamic activity, and that users may want to change their plans on the go. | ||||
| - **Discoverability**: Tourism is an inherently exploratory activity. Once a rough itinerary is generated, detours and spontaneous decisions should be encouraged. | ||||
| After Width: | Height: | Size: 106 KiB | 
| After Width: | Height: | Size: 1.3 MiB | 
| After Width: | Height: | Size: 637 KiB | 
| After Width: | Height: | Size: 573 KiB | 
| After Width: | Height: | Size: 175 KiB | 
| After Width: | Height: | Size: 360 KiB | 
| @@ -1,7 +0,0 @@ | ||||
| AnyWay is an application that helps you plan truly unique city trips. When planning a new trip, you can specify your preferences and constraints and anyway generates a personalized itinerary just for you.  | ||||
|  | ||||
| Anyway follows these core principles: | ||||
| - Personalization: Trips should be match your interests - not just the most popular destinations. | ||||
| - Efficiency: Don't just walk in circles! Anyway creates the most efficient route for you. | ||||
| - Flexibility: Vacations are the time to be spontaneous. Anyway lets you update your plans on the go. | ||||
| - Discoverability: Tourism means exploration. Anyway encourages you to take detours and make spontaneous decisions. | ||||
| Before Width: | Height: | Size: 3.0 MiB | 
| Before Width: | Height: | Size: 4.1 MiB | 
| Before Width: | Height: | Size: 1.1 MiB | 
| Before Width: | Height: | Size: 1.1 MiB | 
| @@ -1,4 +1,4 @@ | ||||
| app_identifier("info.anydev.anyway") # The bundle identifier of your app | ||||
| app_identifier("info.anydev.testing") # The bundle identifier of your app | ||||
| apple_id("me@moll.re") # Your Apple Developer Portal username | ||||
|  | ||||
| itc_team_id("127439860") # App Store Connect Team ID | ||||
|   | ||||
| @@ -1,3 +0,0 @@ | ||||
| # The Deliverfile allows you to store various App Store Connect metadata | ||||
| # For more information, check out the docs | ||||
| # https://docs.fastlane.tools/actions/deliver/ | ||||
| @@ -15,7 +15,7 @@ platform :ios do | ||||
|  | ||||
|  | ||||
|   desc "Deploy a new version to closed testing (testflight)" | ||||
|   lane :deploy_beta do | ||||
|   lane :deploy_testing do | ||||
|     build_name = ENV["BUILD_NAME"] | ||||
|     build_number = ENV["BUILD_NUMBER"] | ||||
|      | ||||
| @@ -28,11 +28,12 @@ platform :ios do | ||||
|       readonly: true, | ||||
|     ) | ||||
|  | ||||
|  | ||||
|     sh( | ||||
|       "flutter", | ||||
|       "build", | ||||
|       "ipa", | ||||
|       "--release", | ||||
|       "--debug", | ||||
|       "--build-name=#{build_name}", | ||||
|       "--build-number=#{build_number}", | ||||
|     ) | ||||
| @@ -63,6 +64,15 @@ platform :ios do | ||||
|       readonly: true, | ||||
|     ) | ||||
|  | ||||
|     # replace secrets by real values, the stupid way | ||||
|     sh( | ||||
|       "sed", | ||||
|       "-i", | ||||
|       "", | ||||
|       "s/IOS_GOOGLE_MAPS_API_KEY/#{ENV["IOS_GOOGLE_MAPS_API_KEY"]}/g", | ||||
|       "../Runner/AppDelegate.swift" | ||||
|     ) | ||||
|  | ||||
|     sh( | ||||
|       "flutter", | ||||
|       "build", | ||||
| @@ -79,11 +89,10 @@ platform :ios do | ||||
|     ) | ||||
|  | ||||
|     upload_to_app_store( | ||||
|       overwrite_screenshots: true, | ||||
|       metadata_path: "fastlane/metadata", | ||||
|       screenshots_path: "fastlane/screenshots", | ||||
|       skip_screenshots: true, | ||||
|       skip_metadata: true, | ||||
|       precheck_include_in_app_purchases: false, | ||||
|       force: true, # Skip HTMl report verification | ||||
|  | ||||
|       submit_for_review: true, | ||||
|       automatic_release: true, | ||||
|       # automatically release the app after review | ||||
|   | ||||
| @@ -1 +0,0 @@ | ||||
| 2025 anydev | ||||
| @@ -1,7 +0,0 @@ | ||||
| AnyWay is an application that helps you plan truly unique city trips. When planning a new trip, you can specify your preferences and constraints and anyway generates a personalized itinerary just for you.  | ||||
|  | ||||
| Anyway follows these core principles: | ||||
| - Personalization: Trips should be match your interests - not just the most popular destinations. | ||||
| - Efficiency: Don't just walk in circles! Anyway creates the most efficient route for you. | ||||
| - Flexibility: Vacations are the time to be spontaneous. Anyway lets you update your plans on the go. | ||||
| - Discoverability: Tourism means exploration. Anyway encourages you to take detours and make spontaneous decisions. | ||||
| @@ -1 +0,0 @@ | ||||
| tourism, cities, travel, guide | ||||
| @@ -1 +0,0 @@ | ||||
| https://anydev.info | ||||
| @@ -1 +0,0 @@ | ||||
| Any.Way | ||||
| @@ -1 +0,0 @@ | ||||
| https://anydev.info/privacy | ||||
| @@ -1 +0,0 @@ | ||||
| AnyWay - plan city trips your way! | ||||
| @@ -1 +0,0 @@ | ||||
|  | ||||
| @@ -1 +0,0 @@ | ||||
| Plan city trips your way! | ||||
| @@ -1 +0,0 @@ | ||||
|  | ||||
| @@ -1 +0,0 @@ | ||||
| TRAVEL | ||||
| @@ -1 +0,0 @@ | ||||
| anydev.anyway@gmail.com | ||||
| @@ -1 +0,0 @@ | ||||
| Remy | ||||
| @@ -1 +0,0 @@ | ||||
| Moll | ||||
| @@ -1 +0,0 @@ | ||||
|  | ||||
| @@ -1 +0,0 @@ | ||||
| +4915128785827 | ||||
| @@ -1 +0,0 @@ | ||||
|  | ||||
| @@ -1,30 +0,0 @@ | ||||
| ## Screenshots Naming Rules | ||||
|  | ||||
| Put all screenshots you want to use inside the folder of its language (e.g. `en-US`). | ||||
| The device type will automatically be recognized using the image resolution. | ||||
|  | ||||
| The screenshots can be named whatever you want, but keep in mind they are sorted | ||||
| alphabetically, in a human-friendly way. See https://github.com/fastlane/fastlane/pull/18200 for more details. | ||||
|  | ||||
| ### Exceptions | ||||
|  | ||||
| #### iPad Pro (3rd Gen) 12.9" | ||||
|  | ||||
| Since iPad Pro (3rd Gen) 12.9" and iPad Pro (2nd Gen) 12.9" have the same image | ||||
| resolution, screenshots of the iPad Pro (3rd gen) 12.9" must contain either the | ||||
| string `iPad Pro (12.9-inch) (3rd generation)`, `IPAD_PRO_3GEN_129`, or `ipadPro129` | ||||
| (App Store Connect's internal naming of the display family for the 3rd generation iPad Pro) | ||||
| in its filename to be assigned the correct display family and to be uploaded to | ||||
| the correct screenshot slot in your app's metadata. | ||||
|  | ||||
| ### Other Platforms | ||||
|  | ||||
| #### Apple TV | ||||
|  | ||||
| Apple TV screenshots should be stored in a subdirectory named `appleTV` with language | ||||
| folders inside of it. | ||||
|  | ||||
| #### iMessage | ||||
|  | ||||
| iMessage screenshots, like the Apple TV ones, should also be stored in a subdirectory | ||||
| named `iMessage`, with language folders inside of it. | ||||
| Before Width: | Height: | Size: 1.6 MiB | 
| Before Width: | Height: | Size: 2.1 MiB | 
| Before Width: | Height: | Size: 626 KiB | 
| Before Width: | Height: | Size: 758 KiB | 
| Before Width: | Height: | Size: 2.2 MiB | 
| Before Width: | Height: | Size: 2.5 MiB | 
| Before Width: | Height: | Size: 574 KiB | 
| Before Width: | Height: | Size: 800 KiB | 
| @@ -16,27 +16,22 @@ class CurrentTripErrorMessage extends StatefulWidget { | ||||
| class _CurrentTripErrorMessageState extends State<CurrentTripErrorMessage> { | ||||
|   @override | ||||
|   Widget build(BuildContext context) => Center( | ||||
|     child: Column( | ||||
|     child: Row( | ||||
|       mainAxisAlignment: MainAxisAlignment.center, | ||||
|       crossAxisAlignment: CrossAxisAlignment.center, | ||||
|       children: [ | ||||
|         Text( | ||||
|           "😢", | ||||
|           style: TextStyle( | ||||
|             fontSize: 40, | ||||
|           ), | ||||
|         const Icon( | ||||
|           Icons.error_outline, | ||||
|           color: Colors.red, | ||||
|           size: 50, | ||||
|         ), | ||||
|         const Padding( | ||||
|           padding: EdgeInsets.only(left: 10), | ||||
|         ), | ||||
|         const SizedBox(height: 10), | ||||
|         AutoSizeText( | ||||
|           // at this point the trip is guaranteed to have an error message | ||||
|           widget.trip.errorDescription!, | ||||
|           maxLines: 30, | ||||
|           style: Theme.of(context).textTheme.bodyMedium, | ||||
|           textAlign: TextAlign.center, | ||||
|  | ||||
|           'Error: ${widget.trip.errorDescription}', | ||||
|           maxLines: 3, | ||||
|         ), | ||||
|       ], | ||||
|     ), | ||||
|     ) | ||||
|   ); | ||||
|  | ||||
| } | ||||
|   | ||||
| @@ -1,5 +1,3 @@ | ||||
| import 'package:anyway/pages/current_trip.dart'; | ||||
| import 'package:auto_size_text/auto_size_text.dart'; | ||||
| import 'package:flutter/material.dart'; | ||||
|  | ||||
| import 'package:anyway/constants.dart'; | ||||
| @@ -36,27 +34,15 @@ class _CurrentTripPanelState extends State<CurrentTripPanel> { | ||||
|       listenable: widget.trip, | ||||
|       builder: (context, child) { | ||||
|         if (widget.trip.uuid == 'error') { | ||||
|           return ListView( | ||||
|             controller: widget.controller, | ||||
|             padding: const EdgeInsets.only(top: 10, left: 10, right: 10, bottom: 30), | ||||
|             children: [ | ||||
|               SizedBox( | ||||
|           return Align( | ||||
|               alignment: Alignment.topCenter, | ||||
|               child: SizedBox( | ||||
|                 // reuse the exact same height as the panel has when collapsed | ||||
|                 // this way the greeter will be centered when the panel is collapsed | ||||
|                 // note that we need to account for the padding above | ||||
|                 height: MediaQuery.of(context).size.height * TRIP_PANEL_MIN_HEIGHT - 10, | ||||
|                 child: Center(child:  | ||||
|                   AutoSizeText( | ||||
|                     maxLines: 1, | ||||
|                     'Error', | ||||
|                     style: greeterStyle | ||||
|                   ) | ||||
|                 ), | ||||
|                 height: MediaQuery.of(context).size.height * TRIP_PANEL_MIN_HEIGHT, | ||||
|                 child: CurrentTripErrorMessage(trip: widget.trip) | ||||
|               ), | ||||
|  | ||||
|               CurrentTripErrorMessage(trip: widget.trip), | ||||
|             ], | ||||
|           ); | ||||
|             ); | ||||
|         } else if (widget.trip.uuid == 'pending') { | ||||
|             return Align( | ||||
|               alignment: Alignment.topCenter, | ||||
|   | ||||
| @@ -34,6 +34,23 @@ class _NewTripPreferencesPageState extends State<NewTripPreferencesPage> with Sc | ||||
|       child: Scaffold( | ||||
|         body: ListView( | ||||
|           children: [ | ||||
|             // Center( | ||||
|             //   child: CircleAvatar( | ||||
|             //     radius: 100, | ||||
|             //     child: Icon(Icons.person, size: 100), | ||||
|             //   ) | ||||
|             // ), | ||||
|             // Padding(padding: EdgeInsets.only(top: 30)), | ||||
|             // Center( | ||||
|             //   child: FutureBuilder( | ||||
|             //     future: widget.trip.cityName, | ||||
|             //     builder: (context, snapshot) => Text( | ||||
|             //       'Your trip to ${snapshot.hasData ? snapshot.data! : "..."}', | ||||
|             //       style: TextStyle(fontSize: 24, fontWeight: FontWeight.bold) | ||||
|             //     ) | ||||
|             //   ) | ||||
|             // ), | ||||
|  | ||||
|           Center( | ||||
|             child: Padding( | ||||
|             padding: EdgeInsets.only(left: 10, right: 10, top: 20, bottom: 0), | ||||
| @@ -46,11 +63,6 @@ class _NewTripPreferencesPageState extends State<NewTripPreferencesPage> with Sc | ||||
|           durationPicker(preferences.maxTime), | ||||
|  | ||||
|           preferenceSliders([preferences.sightseeing, preferences.shopping, preferences.nature]), | ||||
|  | ||||
|           // Add a conditional padding to avoid the floating button covering the last slider | ||||
|           Padding( | ||||
|             padding: EdgeInsets.only(bottom: MediaQuery.of(context).viewInsets.bottom + 80), | ||||
|             ), | ||||
|         ] | ||||
|       ), | ||||
|       floatingActionButton: NewTripButton(trip: widget.trip, preferences: preferences), | ||||
|   | ||||
| @@ -21,13 +21,10 @@ class _NoTripsPageState extends State<NoTripsPage> with ScaffoldLayout { | ||||
|             Text( | ||||
|               "No trips yet", | ||||
|               style: Theme.of(context).textTheme.headlineMedium, | ||||
|               textAlign: TextAlign.center, | ||||
|             ), | ||||
|             Padding(padding: EdgeInsets.only(bottom: 10)), | ||||
|             Text( | ||||
|               "You can start a new trip by clicking the button below", | ||||
|               style: Theme.of(context).textTheme.bodyMedium, | ||||
|               textAlign: TextAlign.center, | ||||
|             ), | ||||
|           ], | ||||
|         ), | ||||
|   | ||||
| @@ -177,7 +177,7 @@ class _SettingsPageState extends State<SettingsPage> with ScaffoldLayout { | ||||
|     return Center( | ||||
|       child: Column( | ||||
|         children: [ | ||||
|           Text('AnyWay does not collect or store any of the data that is submitted via the app. The location of your trip is not stored. The location feature is only used to show your current location on the map.', textAlign: TextAlign.center), | ||||
|           Text('AnyWay does not collect or store any of the data that is submitted via the app. The location of your trip is not stored. The location feature is only used to show your current location on the map, it is not transmitted to our servers.', textAlign: TextAlign.center), | ||||
|           Padding(padding: EdgeInsets.only(top: 3)), | ||||
|           Text('Our full privacy policy is available under:', textAlign: TextAlign.center), | ||||
|            | ||||
|   | ||||
| @@ -1,7 +1,5 @@ | ||||
| import "dart:async"; | ||||
| import "dart:convert"; | ||||
| import "dart:developer"; | ||||
| import "dart:io"; | ||||
| import "package:anyway/main.dart"; | ||||
| import 'package:dio/dio.dart'; | ||||
|  | ||||
| @@ -20,6 +18,11 @@ Dio dio = Dio( | ||||
|     // also accept 500 errors, since we cannot rule out that the server is at fault. We still want to gracefully handle these errors | ||||
|     validateStatus: (status) => status! <= 500, | ||||
|     receiveDataWhenStatusError: true, | ||||
|     // api is notoriously slow | ||||
|     // headers: { | ||||
|     //   HttpHeaders.userAgentHeader: 'dio', | ||||
|     //   'api': '1.0.0', | ||||
|     // }, | ||||
|     contentType: Headers.jsonContentType, | ||||
|     responseType: ResponseType.json,     | ||||
|   ), | ||||
| @@ -45,70 +48,25 @@ fetchTrip( | ||||
|     ); | ||||
|   } catch (e) { | ||||
|     trip.updateUUID("error"); | ||||
|        | ||||
|     // Format the error message to be more user friendly | ||||
|     String errorDescription; | ||||
|     if (e is DioException) { | ||||
|         errorDescription = e.message ?? "Unknown error"; | ||||
|     } else if (e is SocketException) { | ||||
|         errorDescription = "No internet connection"; | ||||
|     } else if (e is TimeoutException) { | ||||
|         errorDescription = "Request timed out"; | ||||
|     } else { | ||||
|         errorDescription = "Unknown error"; | ||||
|     } | ||||
|  | ||||
|     String errorMessage = """ | ||||
|       We're sorry, the following error was generated: | ||||
|  | ||||
|       ${errorDescription.trim()} | ||||
|     """.trim(); | ||||
|  | ||||
|     trip.updateError(errorMessage); | ||||
|     trip.updateError(e.toString()); | ||||
|     log(e.toString()); | ||||
|     log(errorMessage); | ||||
|     return; | ||||
|   } | ||||
|  | ||||
|   // handle more specific errors | ||||
|   // handle errors | ||||
|   if (response.statusCode != 200) { | ||||
|     trip.updateUUID("error"); | ||||
|     String errorDescription; | ||||
|     String errorDetail; | ||||
|     if (response.data.runtimeType == String) { | ||||
|       errorDescription = response.data; | ||||
|     } else if (response.data.runtimeType == Map<String, dynamic>) { | ||||
|       errorDescription = response.data["detail"] ?? "Unknown error"; | ||||
|       errorDetail = response.data; | ||||
|     } else { | ||||
|       errorDescription = "Unknown error"; | ||||
|       errorDetail = response.data["detail"] ?? "Unknown error"; | ||||
|     } | ||||
|  | ||||
|     String errorMessage = """ | ||||
|       We're sorry, our servers generated the following error: | ||||
|  | ||||
|       ${errorDescription.trim()} | ||||
|       Please try again. | ||||
|     """.trim(); | ||||
|     trip.updateError(errorMessage); | ||||
|     log(errorMessage); | ||||
|     trip.updateError(errorDetail); | ||||
|     log(errorDetail); | ||||
|     // Actualy no need to throw an exception, we can just log the error and let the user retry | ||||
|     // throw Exception(errorDetail); | ||||
|   } else { | ||||
|      | ||||
|     // if the response data is not json, throw an error | ||||
|     if (response.data is! Map<String, dynamic>) { | ||||
|       log("${response.data.runtimeType}"); | ||||
|       trip.updateUUID("error"); | ||||
|       String errorMessage = """ | ||||
|         We're sorry, our servers generated the following error: | ||||
|  | ||||
|         ${response.data.trim()} | ||||
|         Please try again. | ||||
|       """.trim(); | ||||
|       trip.updateError(errorMessage); | ||||
|       log(errorMessage); | ||||
|       return; | ||||
|     } | ||||
|  | ||||
|     Map<String, dynamic> json = response.data; | ||||
|  | ||||
|     // only fill in the trip "meta" data for now | ||||
|   | ||||
							
								
								
									
										1
									
								
								frontend/linux/.gitignore
									
									
									
									
										vendored
									
									
								
							
							
						
						| @@ -1 +0,0 @@ | ||||
| flutter/ephemeral | ||||
| @@ -1,128 +0,0 @@ | ||||
| # Project-level configuration. | ||||
| cmake_minimum_required(VERSION 3.13) | ||||
| project(runner LANGUAGES CXX) | ||||
|  | ||||
| # The name of the executable created for the application. Change this to change | ||||
| # the on-disk name of your application. | ||||
| set(BINARY_NAME "anyway") | ||||
| # The unique GTK application identifier for this application. See: | ||||
| # https://wiki.gnome.org/HowDoI/ChooseApplicationID | ||||
| set(APPLICATION_ID "com.anydev.anyway") | ||||
|  | ||||
| # Explicitly opt in to modern CMake behaviors to avoid warnings with recent | ||||
| # versions of CMake. | ||||
| cmake_policy(SET CMP0063 NEW) | ||||
|  | ||||
| # Load bundled libraries from the lib/ directory relative to the binary. | ||||
| set(CMAKE_INSTALL_RPATH "$ORIGIN/lib") | ||||
|  | ||||
| # Root filesystem for cross-building. | ||||
| if(FLUTTER_TARGET_PLATFORM_SYSROOT) | ||||
|   set(CMAKE_SYSROOT ${FLUTTER_TARGET_PLATFORM_SYSROOT}) | ||||
|   set(CMAKE_FIND_ROOT_PATH ${CMAKE_SYSROOT}) | ||||
|   set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER) | ||||
|   set(CMAKE_FIND_ROOT_PATH_MODE_PACKAGE ONLY) | ||||
|   set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY) | ||||
|   set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY) | ||||
| endif() | ||||
|  | ||||
| # Define build configuration options. | ||||
| if(NOT CMAKE_BUILD_TYPE AND NOT CMAKE_CONFIGURATION_TYPES) | ||||
|   set(CMAKE_BUILD_TYPE "Debug" CACHE | ||||
|     STRING "Flutter build mode" FORCE) | ||||
|   set_property(CACHE CMAKE_BUILD_TYPE PROPERTY STRINGS | ||||
|     "Debug" "Profile" "Release") | ||||
| endif() | ||||
|  | ||||
| # Compilation settings that should be applied to most targets. | ||||
| # | ||||
| # Be cautious about adding new options here, as plugins use this function by | ||||
| # default. In most cases, you should add new options to specific targets instead | ||||
| # of modifying this function. | ||||
| function(APPLY_STANDARD_SETTINGS TARGET) | ||||
|   target_compile_features(${TARGET} PUBLIC cxx_std_14) | ||||
|   target_compile_options(${TARGET} PRIVATE -Wall -Werror) | ||||
|   target_compile_options(${TARGET} PRIVATE "$<$<NOT:$<CONFIG:Debug>>:-O3>") | ||||
|   target_compile_definitions(${TARGET} PRIVATE "$<$<NOT:$<CONFIG:Debug>>:NDEBUG>") | ||||
| endfunction() | ||||
|  | ||||
| # Flutter library and tool build rules. | ||||
| set(FLUTTER_MANAGED_DIR "${CMAKE_CURRENT_SOURCE_DIR}/flutter") | ||||
| add_subdirectory(${FLUTTER_MANAGED_DIR}) | ||||
|  | ||||
| # System-level dependencies. | ||||
| find_package(PkgConfig REQUIRED) | ||||
| pkg_check_modules(GTK REQUIRED IMPORTED_TARGET gtk+-3.0) | ||||
|  | ||||
| # Application build; see runner/CMakeLists.txt. | ||||
| add_subdirectory("runner") | ||||
|  | ||||
| # Run the Flutter tool portions of the build. This must not be removed. | ||||
| add_dependencies(${BINARY_NAME} flutter_assemble) | ||||
|  | ||||
| # Only the install-generated bundle's copy of the executable will launch | ||||
| # correctly, since the resources must in the right relative locations. To avoid | ||||
| # people trying to run the unbundled copy, put it in a subdirectory instead of | ||||
| # the default top-level location. | ||||
| set_target_properties(${BINARY_NAME} | ||||
|   PROPERTIES | ||||
|   RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/intermediates_do_not_run" | ||||
| ) | ||||
|  | ||||
|  | ||||
| # Generated plugin build rules, which manage building the plugins and adding | ||||
| # them to the application. | ||||
| include(flutter/generated_plugins.cmake) | ||||
|  | ||||
|  | ||||
| # === Installation === | ||||
| # By default, "installing" just makes a relocatable bundle in the build | ||||
| # directory. | ||||
| set(BUILD_BUNDLE_DIR "${PROJECT_BINARY_DIR}/bundle") | ||||
| if(CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT) | ||||
|   set(CMAKE_INSTALL_PREFIX "${BUILD_BUNDLE_DIR}" CACHE PATH "..." FORCE) | ||||
| endif() | ||||
|  | ||||
| # Start with a clean build bundle directory every time. | ||||
| install(CODE " | ||||
|   file(REMOVE_RECURSE \"${BUILD_BUNDLE_DIR}/\") | ||||
|   " COMPONENT Runtime) | ||||
|  | ||||
| set(INSTALL_BUNDLE_DATA_DIR "${CMAKE_INSTALL_PREFIX}/data") | ||||
| set(INSTALL_BUNDLE_LIB_DIR "${CMAKE_INSTALL_PREFIX}/lib") | ||||
|  | ||||
| install(TARGETS ${BINARY_NAME} RUNTIME DESTINATION "${CMAKE_INSTALL_PREFIX}" | ||||
|   COMPONENT Runtime) | ||||
|  | ||||
| install(FILES "${FLUTTER_ICU_DATA_FILE}" DESTINATION "${INSTALL_BUNDLE_DATA_DIR}" | ||||
|   COMPONENT Runtime) | ||||
|  | ||||
| install(FILES "${FLUTTER_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_LIB_DIR}" | ||||
|   COMPONENT Runtime) | ||||
|  | ||||
| foreach(bundled_library ${PLUGIN_BUNDLED_LIBRARIES}) | ||||
|   install(FILES "${bundled_library}" | ||||
|     DESTINATION "${INSTALL_BUNDLE_LIB_DIR}" | ||||
|     COMPONENT Runtime) | ||||
| endforeach(bundled_library) | ||||
|  | ||||
| # Copy the native assets provided by the build.dart from all packages. | ||||
| set(NATIVE_ASSETS_DIR "${PROJECT_BUILD_DIR}native_assets/linux/") | ||||
| install(DIRECTORY "${NATIVE_ASSETS_DIR}" | ||||
|    DESTINATION "${INSTALL_BUNDLE_LIB_DIR}" | ||||
|    COMPONENT Runtime) | ||||
|  | ||||
| # Fully re-copy the assets directory on each build to avoid having stale files | ||||
| # from a previous install. | ||||
| set(FLUTTER_ASSET_DIR_NAME "flutter_assets") | ||||
| install(CODE " | ||||
|   file(REMOVE_RECURSE \"${INSTALL_BUNDLE_DATA_DIR}/${FLUTTER_ASSET_DIR_NAME}\") | ||||
|   " COMPONENT Runtime) | ||||
| install(DIRECTORY "${PROJECT_BUILD_DIR}/${FLUTTER_ASSET_DIR_NAME}" | ||||
|   DESTINATION "${INSTALL_BUNDLE_DATA_DIR}" COMPONENT Runtime) | ||||
|  | ||||
| # Install the AOT library on non-Debug builds only. | ||||
| if(NOT CMAKE_BUILD_TYPE MATCHES "Debug") | ||||
|   install(FILES "${AOT_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_LIB_DIR}" | ||||
|     COMPONENT Runtime) | ||||
| endif() | ||||
| @@ -1,88 +0,0 @@ | ||||
| # This file controls Flutter-level build steps. It should not be edited. | ||||
| cmake_minimum_required(VERSION 3.10) | ||||
|  | ||||
| set(EPHEMERAL_DIR "${CMAKE_CURRENT_SOURCE_DIR}/ephemeral") | ||||
|  | ||||
| # Configuration provided via flutter tool. | ||||
| include(${EPHEMERAL_DIR}/generated_config.cmake) | ||||
|  | ||||
| # TODO: Move the rest of this into files in ephemeral. See | ||||
| # https://github.com/flutter/flutter/issues/57146. | ||||
|  | ||||
| # Serves the same purpose as list(TRANSFORM ... PREPEND ...), | ||||
| # which isn't available in 3.10. | ||||
| function(list_prepend LIST_NAME PREFIX) | ||||
|     set(NEW_LIST "") | ||||
|     foreach(element ${${LIST_NAME}}) | ||||
|         list(APPEND NEW_LIST "${PREFIX}${element}") | ||||
|     endforeach(element) | ||||
|     set(${LIST_NAME} "${NEW_LIST}" PARENT_SCOPE) | ||||
| endfunction() | ||||
|  | ||||
| # === Flutter Library === | ||||
| # System-level dependencies. | ||||
| find_package(PkgConfig REQUIRED) | ||||
| pkg_check_modules(GTK REQUIRED IMPORTED_TARGET gtk+-3.0) | ||||
| pkg_check_modules(GLIB REQUIRED IMPORTED_TARGET glib-2.0) | ||||
| pkg_check_modules(GIO REQUIRED IMPORTED_TARGET gio-2.0) | ||||
|  | ||||
| set(FLUTTER_LIBRARY "${EPHEMERAL_DIR}/libflutter_linux_gtk.so") | ||||
|  | ||||
| # Published to parent scope for install step. | ||||
| set(FLUTTER_LIBRARY ${FLUTTER_LIBRARY} PARENT_SCOPE) | ||||
| set(FLUTTER_ICU_DATA_FILE "${EPHEMERAL_DIR}/icudtl.dat" PARENT_SCOPE) | ||||
| set(PROJECT_BUILD_DIR "${PROJECT_DIR}/build/" PARENT_SCOPE) | ||||
| set(AOT_LIBRARY "${PROJECT_DIR}/build/lib/libapp.so" PARENT_SCOPE) | ||||
|  | ||||
| list(APPEND FLUTTER_LIBRARY_HEADERS | ||||
|   "fl_basic_message_channel.h" | ||||
|   "fl_binary_codec.h" | ||||
|   "fl_binary_messenger.h" | ||||
|   "fl_dart_project.h" | ||||
|   "fl_engine.h" | ||||
|   "fl_json_message_codec.h" | ||||
|   "fl_json_method_codec.h" | ||||
|   "fl_message_codec.h" | ||||
|   "fl_method_call.h" | ||||
|   "fl_method_channel.h" | ||||
|   "fl_method_codec.h" | ||||
|   "fl_method_response.h" | ||||
|   "fl_plugin_registrar.h" | ||||
|   "fl_plugin_registry.h" | ||||
|   "fl_standard_message_codec.h" | ||||
|   "fl_standard_method_codec.h" | ||||
|   "fl_string_codec.h" | ||||
|   "fl_value.h" | ||||
|   "fl_view.h" | ||||
|   "flutter_linux.h" | ||||
| ) | ||||
| list_prepend(FLUTTER_LIBRARY_HEADERS "${EPHEMERAL_DIR}/flutter_linux/") | ||||
| add_library(flutter INTERFACE) | ||||
| target_include_directories(flutter INTERFACE | ||||
|   "${EPHEMERAL_DIR}" | ||||
| ) | ||||
| target_link_libraries(flutter INTERFACE "${FLUTTER_LIBRARY}") | ||||
| target_link_libraries(flutter INTERFACE | ||||
|   PkgConfig::GTK | ||||
|   PkgConfig::GLIB | ||||
|   PkgConfig::GIO | ||||
| ) | ||||
| add_dependencies(flutter flutter_assemble) | ||||
|  | ||||
| # === Flutter tool backend === | ||||
| # _phony_ is a non-existent file to force this command to run every time, | ||||
| # since currently there's no way to get a full input/output list from the | ||||
| # flutter tool. | ||||
| add_custom_command( | ||||
|   OUTPUT ${FLUTTER_LIBRARY} ${FLUTTER_LIBRARY_HEADERS} | ||||
|     ${CMAKE_CURRENT_BINARY_DIR}/_phony_ | ||||
|   COMMAND ${CMAKE_COMMAND} -E env | ||||
|     ${FLUTTER_TOOL_ENVIRONMENT} | ||||
|     "${FLUTTER_ROOT}/packages/flutter_tools/bin/tool_backend.sh" | ||||
|       ${FLUTTER_TARGET_PLATFORM} ${CMAKE_BUILD_TYPE} | ||||
|   VERBATIM | ||||
| ) | ||||
| add_custom_target(flutter_assemble DEPENDS | ||||
|   "${FLUTTER_LIBRARY}" | ||||
|   ${FLUTTER_LIBRARY_HEADERS} | ||||
| ) | ||||
| @@ -1,26 +0,0 @@ | ||||
| cmake_minimum_required(VERSION 3.13) | ||||
| project(runner LANGUAGES CXX) | ||||
|  | ||||
| # Define the application target. To change its name, change BINARY_NAME in the | ||||
| # top-level CMakeLists.txt, not the value here, or `flutter run` will no longer | ||||
| # work. | ||||
| # | ||||
| # Any new source files that you add to the application should be added here. | ||||
| add_executable(${BINARY_NAME} | ||||
|   "main.cc" | ||||
|   "my_application.cc" | ||||
|   "${FLUTTER_MANAGED_DIR}/generated_plugin_registrant.cc" | ||||
| ) | ||||
|  | ||||
| # Apply the standard set of build settings. This can be removed for applications | ||||
| # that need different build settings. | ||||
| apply_standard_settings(${BINARY_NAME}) | ||||
|  | ||||
| # Add preprocessor definitions for the application ID. | ||||
| add_definitions(-DAPPLICATION_ID="${APPLICATION_ID}") | ||||
|  | ||||
| # Add dependency libraries. Add any application-specific dependencies here. | ||||
| target_link_libraries(${BINARY_NAME} PRIVATE flutter) | ||||
| target_link_libraries(${BINARY_NAME} PRIVATE PkgConfig::GTK) | ||||
|  | ||||
| target_include_directories(${BINARY_NAME} PRIVATE "${CMAKE_SOURCE_DIR}") | ||||
| @@ -1,6 +0,0 @@ | ||||
| #include "my_application.h" | ||||
|  | ||||
| int main(int argc, char** argv) { | ||||
|   g_autoptr(MyApplication) app = my_application_new(); | ||||
|   return g_application_run(G_APPLICATION(app), argc, argv); | ||||
| } | ||||
| @@ -1,130 +0,0 @@ | ||||
| #include "my_application.h" | ||||
|  | ||||
| #include <flutter_linux/flutter_linux.h> | ||||
| #ifdef GDK_WINDOWING_X11 | ||||
| #include <gdk/gdkx.h> | ||||
| #endif | ||||
|  | ||||
| #include "flutter/generated_plugin_registrant.h" | ||||
|  | ||||
| struct _MyApplication { | ||||
|   GtkApplication parent_instance; | ||||
|   char** dart_entrypoint_arguments; | ||||
| }; | ||||
|  | ||||
| G_DEFINE_TYPE(MyApplication, my_application, GTK_TYPE_APPLICATION) | ||||
|  | ||||
| // Implements GApplication::activate. | ||||
| static void my_application_activate(GApplication* application) { | ||||
|   MyApplication* self = MY_APPLICATION(application); | ||||
|   GtkWindow* window = | ||||
|       GTK_WINDOW(gtk_application_window_new(GTK_APPLICATION(application))); | ||||
|  | ||||
|   // Use a header bar when running in GNOME as this is the common style used | ||||
|   // by applications and is the setup most users will be using (e.g. Ubuntu | ||||
|   // desktop). | ||||
|   // If running on X and not using GNOME then just use a traditional title bar | ||||
|   // in case the window manager does more exotic layout, e.g. tiling. | ||||
|   // If running on Wayland assume the header bar will work (may need changing | ||||
|   // if future cases occur). | ||||
|   gboolean use_header_bar = TRUE; | ||||
| #ifdef GDK_WINDOWING_X11 | ||||
|   GdkScreen* screen = gtk_window_get_screen(window); | ||||
|   if (GDK_IS_X11_SCREEN(screen)) { | ||||
|     const gchar* wm_name = gdk_x11_screen_get_window_manager_name(screen); | ||||
|     if (g_strcmp0(wm_name, "GNOME Shell") != 0) { | ||||
|       use_header_bar = FALSE; | ||||
|     } | ||||
|   } | ||||
| #endif | ||||
|   if (use_header_bar) { | ||||
|     GtkHeaderBar* header_bar = GTK_HEADER_BAR(gtk_header_bar_new()); | ||||
|     gtk_widget_show(GTK_WIDGET(header_bar)); | ||||
|     gtk_header_bar_set_title(header_bar, "anyway"); | ||||
|     gtk_header_bar_set_show_close_button(header_bar, TRUE); | ||||
|     gtk_window_set_titlebar(window, GTK_WIDGET(header_bar)); | ||||
|   } else { | ||||
|     gtk_window_set_title(window, "anyway"); | ||||
|   } | ||||
|  | ||||
|   gtk_window_set_default_size(window, 1280, 720); | ||||
|   gtk_widget_show(GTK_WIDGET(window)); | ||||
|  | ||||
|   g_autoptr(FlDartProject) project = fl_dart_project_new(); | ||||
|   fl_dart_project_set_dart_entrypoint_arguments(project, self->dart_entrypoint_arguments); | ||||
|  | ||||
|   FlView* view = fl_view_new(project); | ||||
|   gtk_widget_show(GTK_WIDGET(view)); | ||||
|   gtk_container_add(GTK_CONTAINER(window), GTK_WIDGET(view)); | ||||
|  | ||||
|   fl_register_plugins(FL_PLUGIN_REGISTRY(view)); | ||||
|  | ||||
|   gtk_widget_grab_focus(GTK_WIDGET(view)); | ||||
| } | ||||
|  | ||||
| // Implements GApplication::local_command_line. | ||||
| static gboolean my_application_local_command_line(GApplication* application, gchar*** arguments, int* exit_status) { | ||||
|   MyApplication* self = MY_APPLICATION(application); | ||||
|   // Strip out the first argument as it is the binary name. | ||||
|   self->dart_entrypoint_arguments = g_strdupv(*arguments + 1); | ||||
|  | ||||
|   g_autoptr(GError) error = nullptr; | ||||
|   if (!g_application_register(application, nullptr, &error)) { | ||||
|      g_warning("Failed to register: %s", error->message); | ||||
|      *exit_status = 1; | ||||
|      return TRUE; | ||||
|   } | ||||
|  | ||||
|   g_application_activate(application); | ||||
|   *exit_status = 0; | ||||
|  | ||||
|   return TRUE; | ||||
| } | ||||
|  | ||||
| // Implements GApplication::startup. | ||||
| static void my_application_startup(GApplication* application) { | ||||
|   //MyApplication* self = MY_APPLICATION(object); | ||||
|  | ||||
|   // Perform any actions required at application startup. | ||||
|  | ||||
|   G_APPLICATION_CLASS(my_application_parent_class)->startup(application); | ||||
| } | ||||
|  | ||||
| // Implements GApplication::shutdown. | ||||
| static void my_application_shutdown(GApplication* application) { | ||||
|   //MyApplication* self = MY_APPLICATION(object); | ||||
|  | ||||
|   // Perform any actions required at application shutdown. | ||||
|  | ||||
|   G_APPLICATION_CLASS(my_application_parent_class)->shutdown(application); | ||||
| } | ||||
|  | ||||
| // Implements GObject::dispose. | ||||
| static void my_application_dispose(GObject* object) { | ||||
|   MyApplication* self = MY_APPLICATION(object); | ||||
|   g_clear_pointer(&self->dart_entrypoint_arguments, g_strfreev); | ||||
|   G_OBJECT_CLASS(my_application_parent_class)->dispose(object); | ||||
| } | ||||
|  | ||||
| static void my_application_class_init(MyApplicationClass* klass) { | ||||
|   G_APPLICATION_CLASS(klass)->activate = my_application_activate; | ||||
|   G_APPLICATION_CLASS(klass)->local_command_line = my_application_local_command_line; | ||||
|   G_APPLICATION_CLASS(klass)->startup = my_application_startup; | ||||
|   G_APPLICATION_CLASS(klass)->shutdown = my_application_shutdown; | ||||
|   G_OBJECT_CLASS(klass)->dispose = my_application_dispose; | ||||
| } | ||||
|  | ||||
| static void my_application_init(MyApplication* self) {} | ||||
|  | ||||
| MyApplication* my_application_new() { | ||||
|   // Set the program name to the application ID, which helps various systems | ||||
|   // like GTK and desktop environments map this running application to its | ||||
|   // corresponding .desktop file. This ensures better integration by allowing | ||||
|   // the application to be recognized beyond its binary name. | ||||
|   g_set_prgname(APPLICATION_ID); | ||||
|  | ||||
|   return MY_APPLICATION(g_object_new(my_application_get_type(), | ||||
|                                      "application-id", APPLICATION_ID, | ||||
|                                      "flags", G_APPLICATION_NON_UNIQUE, | ||||
|                                      nullptr)); | ||||
| } | ||||
| @@ -1,18 +0,0 @@ | ||||
| #ifndef FLUTTER_MY_APPLICATION_H_ | ||||
| #define FLUTTER_MY_APPLICATION_H_ | ||||
|  | ||||
| #include <gtk/gtk.h> | ||||
|  | ||||
| G_DECLARE_FINAL_TYPE(MyApplication, my_application, MY, APPLICATION, | ||||
|                      GtkApplication) | ||||
|  | ||||
| /** | ||||
|  * my_application_new: | ||||
|  * | ||||
|  * Creates a new Flutter-based application. | ||||
|  * | ||||
|  * Returns: a new #MyApplication. | ||||
|  */ | ||||
| MyApplication* my_application_new(); | ||||
|  | ||||
| #endif  // FLUTTER_MY_APPLICATION_H_ | ||||
| @@ -1015,4 +1015,4 @@ packages: | ||||
|     version: "3.1.3" | ||||
| sdks: | ||||
|   dart: ">=3.7.0 <4.0.0" | ||||
|   flutter: ">=3.29.1" | ||||
|   flutter: ">=3.27.0" | ||||
|   | ||||
| @@ -20,7 +20,7 @@ version: 1.0.0+1 | ||||
|  | ||||
| environment: | ||||
|   sdk: '>=3.3.4 <4.0.0' | ||||
|   flutter: '3.29.1' | ||||
|   flutter: '>=3.22.0' | ||||
|  | ||||
| # Dependencies specify other packages that your package needs in order to work. | ||||
| # To automatically upgrade your package dependencies to the latest versions | ||||
|   | ||||
| @@ -1,30 +0,0 @@ | ||||
| // This is a basic Flutter widget test. | ||||
| // | ||||
| // To perform an interaction with a widget in your test, use the WidgetTester | ||||
| // utility in the flutter_test package. For example, you can send tap and scroll | ||||
| // gestures. You can also use WidgetTester to find child widgets in the widget | ||||
| // tree, read text, and verify that the values of widget properties are correct. | ||||
|  | ||||
| import 'package:flutter/material.dart'; | ||||
| import 'package:flutter_test/flutter_test.dart'; | ||||
|  | ||||
| import 'package:anyway/main.dart'; | ||||
|  | ||||
| void main() { | ||||
|   testWidgets('Counter increments smoke test', (WidgetTester tester) async { | ||||
|     // Build our app and trigger a frame. | ||||
|     await tester.pumpWidget(const MyApp()); | ||||
|  | ||||
|     // Verify that our counter starts at 0. | ||||
|     expect(find.text('0'), findsOneWidget); | ||||
|     expect(find.text('1'), findsNothing); | ||||
|  | ||||
|     // Tap the '+' icon and trigger a frame. | ||||
|     await tester.tap(find.byIcon(Icons.add)); | ||||
|     await tester.pump(); | ||||
|  | ||||
|     // Verify that our counter has incremented. | ||||
|     expect(find.text('0'), findsNothing); | ||||
|     expect(find.text('1'), findsOneWidget); | ||||
|   }); | ||||
| } | ||||
							
								
								
									
										48
									
								
								status
									
									
									
									
									
										Normal file
									
								
							
							
						
						| @@ -0,0 +1,48 @@ | ||||
| error: wrong number of arguments, should be from 1 to 2 | ||||
| usage: git config [<options>] | ||||
|  | ||||
| Config file location | ||||
|     --[no-]global         use global config file | ||||
|     --[no-]system         use system config file | ||||
|     --[no-]local          use repository config file | ||||
|     --[no-]worktree       use per-worktree config file | ||||
|     -f, --[no-]file <file> | ||||
|                           use given config file | ||||
|     --[no-]blob <blob-id> read config from given blob object | ||||
|  | ||||
| Action | ||||
|     --[no-]get            get value: name [value-pattern] | ||||
|     --[no-]get-all        get all values: key [value-pattern] | ||||
|     --[no-]get-regexp     get values for regexp: name-regex [value-pattern] | ||||
|     --[no-]get-urlmatch   get value specific for the URL: section[.var] URL | ||||
|     --[no-]replace-all    replace all matching variables: name value [value-pattern] | ||||
|     --[no-]add            add a new variable: name value | ||||
|     --[no-]unset          remove a variable: name [value-pattern] | ||||
|     --[no-]unset-all      remove all matches: name [value-pattern] | ||||
|     --[no-]rename-section rename section: old-name new-name | ||||
|     --[no-]remove-section remove a section: name | ||||
|     -l, --[no-]list       list all | ||||
|     --[no-]fixed-value    use string equality when comparing values to 'value-pattern' | ||||
|     -e, --[no-]edit       open an editor | ||||
|     --[no-]get-color      find the color configured: slot [default] | ||||
|     --[no-]get-colorbool  find the color setting: slot [stdout-is-tty] | ||||
|  | ||||
| Type | ||||
|     -t, --[no-]type <type> | ||||
|                           value is given this type | ||||
|     --bool                value is "true" or "false" | ||||
|     --int                 value is decimal number | ||||
|     --bool-or-int         value is --bool or --int | ||||
|     --bool-or-str         value is --bool or string | ||||
|     --path                value is a path (file or directory name) | ||||
|     --expiry-date         value is an expiry date | ||||
|  | ||||
| Other | ||||
|     -z, --[no-]null       terminate values with NUL byte | ||||
|     --[no-]name-only      show variable names only | ||||
|     --[no-]includes       respect include directives on lookup | ||||
|     --[no-]show-origin    show origin of config (file, standard input, blob, command line) | ||||
|     --[no-]show-scope     show scope of config (worktree, local, global, system, command) | ||||
|     --[no-]default <value> | ||||
|                           with --get, use default value when missing entry | ||||
|  | ||||