---

iOS Share Plugin

Godot iOS Share Plugin allows sharing of text and images on the iOS platform.

Android Version

Android version of this plugin can be found at the following link:

• https://github.com/cengiz-pz/godot-android-share-plugin

Installation

There are 2 ways to install the Share Plugin into your project:

• Through the Godot Editor's AssetLib
• Manually by downloading the release archive from Github

Steps to install via AssetLib

• search for and select the iOS Share Plugin in Godot Editor's AssetLib tab
• click Download button
• on the installation dialog...
  • leave your project's root directory selected as the target directory
  • leave Ignore asset root checkbox checked
  • click Install button
• enable the addon via the Plugins tab of Project->Project Settings... menu, in the Godot Editor
• enable the plugin in your project's iOS export settings via Project->Export...->iOS in the Godot Editor

Manual installation steps

• download release archive from Github
• unzip the release archive
• copy contents of the unzipped directory into your project's root directory
• enable the plugin via the Plugins tab of Project->Project Settings... menu, in the Godot Editor

Usage

Add a Share node to your scene and follow the following steps:

• use one of the following methods of the Share node to share text or images:
  - share_text(title, subject, content)
  - share_image(full_path_for_saved_image_file, title, subject, content)
  - Note that the image you want to share must be saved under the user:// virtual directory in order to be accessible. The OS.get_user_data_dir() method can be used to get the absolute path for the user:// directory. See the implementation of share_viewport() method for sample code.
  - share_viewport(viewport, title, subject, content)

Export to iOS

Follow instructions on the following page to export your project and run on an iOS device:

• Exporting for iOS

---

Credits

Developed by Cengiz

Based on Shin-NiL's Godot Share Plugin

Also based on: Godot iOS Plugin Template

Original repository: Godot iOS Share Plugin

---

Contribution

This section provides information on how to build the plugin for contributors.

---

Prerequisites

• Install SCons
• Install CocoaPods

---

Build

• Run ./script/build.sh -A <godot version> initially to run a full build
• Run ./script/build.sh -cgA <godot version> to clean, redownload Godot, and rebuild
• Run ./script/build.sh -ca to clean and build without redownloading Godot
• Run ./script/build.sh -cb -z4.0 to clean and build plugin without redownloading Godot and package in a zip archive as version 4.0
• Run ./script/build.sh -h for more information on the build script

---

Install Script

• Run ./script/install.sh -t <target directory> -z <path to zip file> install plugin to a Godot project.
• Example ./script/install.sh -t demo -z bin/release/SharePlugin-v4.0.zip to install to demo app.

---

Git addon submodule

Creating

• git submodule add -b main --force --name addon https://github.com/cengiz-pz/godot-share-addon.git addon

Updating

• Remove addon directory
• Run git submodule update --remote --merge

---

Libraries

Library archives will be created in the bin/release directory.

---

All Plugins

Plugin	Android	iOS
Notification Scheduler	https://github.com/cengiz-pz/godot-android-notification-scheduler-plugin	https://github.com/cengiz-pz/godot-ios-notification-scheduler-plugin
Admob	https://github.com/cengiz-pz/godot-android-admob-plugin	https://github.com/cengiz-pz/godot-ios-admob-plugin
Deeplink	https://github.com/cengiz-pz/godot-android-deeplink-plugin	https://github.com/cengiz-pz/godot-ios-deeplink-plugin
Share	https://github.com/cengiz-pz/godot-android-share-plugin	https://github.com/cengiz-pz/godot-ios-share-plugin
In-App Review	https://github.com/cengiz-pz/godot-android-inapp-review-plugin	https://github.com/cengiz-pz/godot-ios-inapp-review-plugin