Environment variables are the variables set outside the projects and typically embedded into the operating system or the service platform the project will be built on.
Developers constantly feel the need to use environment variables in their applications for various reasons. Some of these reasons can be:
<ul>
<li>Using different values for the same variables depending on the project &#8220;environments&#8221; like development, testing, staging and production</li>
<li>Keeping sensitive values and secrets such as API keys and passwords secure so that they are not revealed within the source code</li>
<li>Limit the number of modification to the source code by keeping some information outside the project code and change those values when needed, suitable for things like feature flags and A/B testing</li>
</ul>
For mobile applications, where building the apps is required with every change, environment variables are even more crucial for high configurability. You can enable environment variables in Gradle and configure your CI/CD system to use these values while building.
<h2>Enabling Environment Variables in Gradle</h2>
Android developers can use environment variables using <a href="https://gradle.org">Gradle</a>’s module-level build configuration. This module-level Gradle configuration file lets you specify build settings for that application module.
To use environment variables in your Android app project, specify a new <code>buildConfigField</code> method in the Android block of your build.gradle file, as shown below:
<code>build.gradle file:</code>
<pre><code class="language-gradle">android {
 compileSdkVersion 29
 buildToolsVersion &quot;29.0.2&quot;
 defaultConfig {
 vectorDrawables.useSupportLibrary = true
 applicationId &quot;com.example.appcircle_sample_android&quot;
 minSdkVersion 19
 targetSdkVersion 29
 versionCode 1
 versionName &quot;1.0.0&quot;
 testInstrumentationRunner &quot;androidx.test.runner.AndroidJUnitRunner&quot;
 buildConfigField &quot;String&quot;, &quot;APPCIRCLE_API_URL&quot;, &quot;\&quot;${System.env.AC_API_URL}\&quot;&quot;
 }
 buildTypes {
 release {
 minifyEnabled false
 proguardFiles getDefaultProguardFile(&#039;proguard-android-optimize.txt&#039;), &#039;proguard-rules.pro&#039;
 }
 }
}
</code></pre>
During the build, Gradle will generate the <code>buildConfig</code> class and these variables will be accessible within your application in the runtime.
You can now use this variable in your application. Here is an example showing how to use the defined environment variable in a view:
<pre><code class="language-java">public class SampleFragmentDetail extends Fragment { 
 MainActivity activity;
 
 public SampleFragmentDetail() { 
 // Required empty public constructor 
 } 
 
 public void setActivity(MainActivity activity) { 
 this.activity = activity; 
 } 
 
 @Override 
 public View onCreateView(LayoutInflater inflater, ViewGroup container, 
 Bundle savedInstanceState) { 
 View view = inflater.inflate(R.layout.fragment_sample_detail, container, false);

 activity.showHomeItem(true); 
 TextView appVersionTextView = view.findViewById(R.id.appVersionTextView); 
 appVersionTextView.setText(&quot;Api URL: &quot; + BuildConfig.APPCIRCLE_API_URL); 
 return view; 
 } 
 
 @Override 
 public void onResume() { 
 super.onResume(); 
 }
}</code></pre>
<h2>Setting Environment Variables in Appcircle</h2>
<a href="https://appcircle.io/features" target="_blank" rel="noopener noreferrer">Appcircle allows you to create groups of environment variables to be used during your builds</a>. You can create environment variable groups for different environments of your project like development, staging and production or for different app configurations.
Like the Android sample above, you may want to use different API endpoints for development, staging and production.
To create different values of the same variable, first create an environment variable group for each environment/configuration:
<a href="https://ac.appcircle.io/wp-content/uploads/2020/04/Appcircle_Android_Env_Vars1.png"><img class="alignnone wp-image-385 size-entry_with_sidebar" src="https://ac.appcircle.io/wp-content/uploads/2020/04/Appcircle_Android_Env_Vars1-845x321.png" alt="" width="845" height="321" /></a>
Then, create an environment variable with the same name in each group and set the proper values for each branch.
<blockquote>You can duplicate variable groups for easy environment creation</blockquote>
<a href="https://ac.appcircle.io/wp-content/uploads/2020/04/Appcircle_Android_Env_Vars2.png"><img class="alignnone size-entry_with_sidebar wp-image-394" src="https://ac.appcircle.io/wp-content/uploads/2020/04/Appcircle_Android_Env_Vars2-845x321.png" alt="" width="845" height="321" /></a>
Once the variable groups are set, you can specify which variable group to use in the build configuration for the specific branch. You can set different groups for different branches.
<a href="https://ac.appcircle.io/wp-content/uploads/2020/04/Appcircle_Android_Env_Vars3.png"><img class="alignnone size-entry_with_sidebar wp-image-395" src="https://ac.appcircle.io/wp-content/uploads/2020/04/Appcircle_Android_Env_Vars3-845x321.png" alt="" width="845" height="321" /></a>
During the build, the build agent will get the values for the variables from the designated group for the branch from which you are building your application. Then the build.gradle file in your module will consume the environment variable values for your application to use them during the runtime:
<a href="https://ac.appcircle.io/wp-content/uploads/2020/04/Appcircle_Android_Env_Vars4.png"><img class="alignnone size-entry_with_sidebar wp-image-396" src="https://ac.appcircle.io/wp-content/uploads/2020/04/Appcircle_Android_Env_Vars4-845x321.png" alt="" width="845" height="321" /></a>
With Appcircle, you can easily utilize environment variables in your Android and iOS projects from a single source of truth and keep your secrets secure. You can change environments easily and receive automated builds for different branches utilizing different environment configurations with instant iOS and Android app previews in your browser.
<button class="call-to-action"><a href="https://appcircle.io/start" target="_blank" rel="noopener">Start Using Appcircle Now</a></button>

How to Use Environment Variables with Gradle

Related Posts

Speed Up your Release Process with Appcircle’s Azure Bot for SwiftLint and Detekt

Using Azure Boards for Mobile App Development

Streamline Project Integration and Test Automation with Repeato and Appcircle

Multi-Layered Team Management in Mobile DevOps

How to Use Environment Variables with Gradle

Related Posts

Speed Up your Release Process with Appcircle’s Azure Bot for SwiftLint and Detekt

Using Azure Boards for Mobile App Development

Streamline Project Integration and Test Automation with Repeato and Appcircle

Multi-Layered Team Management in Mobile DevOps

Subscribe to Appcircle Circle