Dart quick start
Last updated: Feb-02-2023
This quick start is intended to let you quickly try using several common Cloudinary features. It doesn't necessarily employ coding best practices and the code you create here isn't intended for production.
You can perform this quick start in a code sandbox or in a clean project in the dev environment of your choice.
You can also view the completed code of this quick start in a GitHub repo.
You may also find our Glossary helpful to understand Cloudinary-specific terminology.
In this quick start you'll learn how to start delivering your media from Cloudinary using the @cloudinary_dart package.
Prerequisites
To perform the steps in this quick start, you'll need:
- A Cloudinary account. If you don't have one yet, you can quickly register for free.
- Your product environment credentials. You can find your credentials in the Dashboard page of your Cloudinary Console.
- A working Dart development environment with a supported version of Dart.
1. Set up and configure the SDK
Install the package
Install the @cloudinary_dart
package by adding Cloudinary as a dependency in your pubspec.yaml file.
Configure Cloudinary
Within your main.dart
file, use your API environment variable to configure your credentials (replace cloudinary://my_key:my_secret@my_cloud_name
below with your environment variable value):
2. Upload an image
You need to use an image in your Cloudinary product environment for the next steps. All new accounts come with sample images, so we'll be using the sample image with public ID cld-sample
for the purposes of this quick start.
If you want to try uploading an image via the Cloudinary Console, expand the following section for instructions:
upload
method of the Upload API as explained in Dart SDK image and video upload or you can use the CLI.3. Transform and deliver the image
Displaying the full image URL based on the specified transformation parameters:
Copy and paste the following code, under the configuration code:
docs/models
asset, you might want to use that public ID instead of cld-sample
. If you're using an image with a public ID other than cld-sample
, make sure to update your code for the remainder of this quick start with the public ID of the image you're delivering.4. Run your code
Run the code to see the transformed image.
View the completed code
This code is available on GitHub.
- Understand the architecture of the Dart SDK and get a more detailed overview of the libraries.
- Find out more about transforming images and videos using
@cloudinary_dart
. - View a comprehensive listing of all available transformations with syntax details and examples in the transformation reference.