Capawesome March 2025 Update

The Capawesome March update is here! This update includes new features and improvements for Capawesome Cloud and our Plugins. Let's take a look at the most important changes.

Cloud

Console

Force Code Signing

You can now enforce code signing for all bundles in your app. This feature ensures that all bundles are signed with a private key before they are uploaded to the Capawesome Cloud, making sure that no unsigned bundles are distributed to your users. You can enable this feature in the settings of your app through the Capawesome Cloud Console.

Git Integration

Capawesome Cloud offers a lightweight Git integration that allows you to link your bundles to Git commits. This way, you can easily track which version of your app is currently live and which changes have been made since the last update. To enable Git integration, simply edit the app in the Capawesome Cloud Console, enable the Git integration toggle and provide the URL of the Git repository. After that, you can use the Capawesome CLI to create a new bundle and link it to a specific commit:

npx capawesome apps:bundles:create --commit-message "feat: support in-app purchases" --commit-ref "main" --commit-sha "b0cb01e"

Check out the documentation for more information.

GitHub Action

Git Integration

The GitHub Action also supports the new Git integration feature.

Plugins

App Shortcuts

The App Shortcuts plugin received various bug fixes and improvements.

Audio Recorder

We have published a new Audio Recorder plugin. This plugin allows you to record audio using the device's microphone. You can start, pause, resume, and stop the recording and get the audio blob or URI. The plugin is available on Android, iOS and Web.

import { AudioRecorder } from '@capawesome-team/capacitor-audio-recorder';
import { NativeAudio } from '@capacitor-community/native-audio';

const startRecording = async () => {
  await AudioRecorder.startRecording();
};

const stopRecording = async () => {
  // Stop recording and get the audio blob or URI
  const { blob, uri } = await AudioRecorder.stopRecording();
  // Play the audio
  if (blob) {
    // Only available on Web
    const audio = new Audio();
    audio.src = URL.createObjectURL(blob);
    audio.play();
  } else if (uri) {
    // Only available on Android and iOS
    await NativeAudio.preload({
      assetId: 'recording',
      assetPath: uri,
      isUrl: true,
    });
    await NativeAudio.play({ assetId: 'recording' });
  }
};

Check out the announcement for more information.

Bluetooth Low Energy

The Bluetooth Low Energy plugin received various bug fixes.

Contacts

We have published a new Contacts plugin. This plugin allows you to create, read, pick, and delete contacts on the device. The plugin is available on Android, iOS and Web.

import { 
  Contacts,
  EmailAddressType,
  PhoneNumberType,
  PostalAddressType
} from '@capawesome-team/capacitor-contacts';

const createContact = async () => {
  return Contacts.createContact({
    contact: {
      givenName: 'John',
      familyName: 'Doe',
      emailAddresses: [
        {
          value: '[email protected]',
          type: EmailAddressType.Home,
          isPrimary: true
        }
      ],
      phoneNumbers: [
        {
          value: '1234567890',
          type: PhoneNumberType.Mobile,
          isPrimary: true
        }
      ],
      postalAddresses: [
        {
          street: '123 Main St',
          city: 'Springfield',
          state: 'IL',
          postalCode: '62701',
          country: 'USA',
          type: PostalAddressType.Home,
          isPrimary: true
        }
      ]
    }
  });
};

Check out the announcement for more information.

Nfc

The Nfc plugin received various bug fixes.

PostHog

New getFeatureFlagPayload(...) method

The PostHog plugin now includes a new getFeatureFlagPayload(...) method. This method allows you to get the payload of a feature flag by its key:

import { Posthog } from "@capawesome-team/capacitor-posthog";

const getFeatureFlagPayload = async () => {
  const { value } = await Posthog.getFeatureFlagPayload({
    key: "beta_feature",
  });
  return value;
};

Speech Recognition

The Speech Recognition plugin received various bug fixes and improvements.

Contextual Strings

You can now provide contextual strings to the startListening(...) method. Contextual strings are phrases that should be recognized, even if they are not in the system vocabulary. For this, a new option has been added to the startListening(...) method:

import { SpeechRecognition } from "@capawesome-team/capacitor-speech-recognition";

const startListening = async () => {
  await SpeechRecognition.startListening({
    contextualStrings: ["Capacitor"],
  });
};

Background Audio

You can now play background audio while using the Speech Recognition plugin. This allows you to play audio while the speech recognition is listening. For this, three new options have been added to the startListening(...) and stopListening(...) methods:

import { AudioSessionCategory, SpeechRecognition } from "@capawesome-team/capacitor-speech-recognition";

const startListening = async () => {
  await SpeechRecognition.startListening({
    // Set the audio session category to play and record 
    // for recording (input) and playback (output) of audio.
    audioSessionCategory: AudioSessionCategory.PlayAndRecord,
    // Do not deactivate the audio session when the plugin stops listening.
    // Otherwise, the background audio will be stopped as well.
    deactivateAudioSessionOnStop: false,
  });
};

const stopListening = async () => {
  await SpeechRecognition.stopListening({
    // Do not deactivate the audio session when the plugin stops listening.
    // Otherwise, the background audio will be stopped as well.
    deactivateAudioSession: false,
  });
};

Permission Types

The Speech Recognition plugin now supports different permission types. You can now request the following permissions:

import { SpeechRecognition } from "@capawesome-team/capacitor-speech-recognition";

const requestPermissions = async () => {
  const { audioRecording, speechRecognition } =
    await SpeechRecognition.requestPermissions({
      permissions: ["audioRecording", "speechRecognition"],
    });
};

The audioRecording permission is available on Android and iOS, while the speechRecognition permission is only available on iOS.