<p>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.</p>
<p>Developers constantly feel the need to use environment variables in their applications for various reasons. Some of these reasons can be:</p>
<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>
<p>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.</p>
<div class="dynamic_cta">
                <img src="/images/icon-left.svg" alt="Left Icon" 
                     class="cta_icon cta_icon_left">
                <h2>Automate Your Builds And Secure Your Secrets</h2>
                <img src="/images/icon-right.svg" alt="Right Icon" 
                     class="cta_icon cta_icon_right">
                <a href="/contact" 
                   class="dynamic_cta_button">Meet Our Experts</a>
            </div>
<h2>Enabling Environment Variables in Gradle</h2>
<p>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.</p>
<p>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:</p>
<p><code>build.gradle file:</code></p>
<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>
<p>During the build, Gradle will generate the <code>buildConfig</code> class and these variables will be accessible within your application in the runtime.</p>
<p>You can now use this variable in your application. Here is an example showing how to use the defined environment variable in a view:</p>
<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>
<p><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.</p>
<p>Like the Android sample above, you may want to use different API endpoints for development, staging and production.</p>
<p>To create different values of the same variable, first create an environment variable group for each environment/configuration:</p>
<p><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="Image related to How to Use Environment Variables with Gradle" width="845" height="321" /></a></p>
<p>Then, create an environment variable with the same name in each group and set the proper values for each branch.</p>
<blockquote><p>You can duplicate variable groups for easy environment creation</p></blockquote>
<p><a href="https://ac.appcircle.io/wp-content/uploads/2020/04/Appcircle_Android_Env_Vars2.png"><img class="alignnone wp-image-394 size-entry_with_sidebar" src="https://ac.appcircle.io/wp-content/uploads/2020/04/Appcircle_Android_Env_Vars2-845x321.png" alt="Image related to How to Use Environment Variables with Gradle" width="845" height="321" /></a></p>
<p>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.</p>
<p><a href="https://ac.appcircle.io/wp-content/uploads/2020/04/Appcircle_Android_Env_Vars3.png"><img class="alignnone wp-image-395 size-entry_with_sidebar" src="https://ac.appcircle.io/wp-content/uploads/2020/04/Appcircle_Android_Env_Vars3-845x321.png" alt="Image related to How to Use Environment Variables with Gradle" width="845" height="321" /></a></p>
<p>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:</p>
<p><a href="https://ac.appcircle.io/wp-content/uploads/2020/04/Appcircle_Android_Env_Vars4.png"><img class="alignnone wp-image-396 size-entry_with_sidebar" src="https://ac.appcircle.io/wp-content/uploads/2020/04/Appcircle_Android_Env_Vars4-845x321.png" alt="Image related to How to Use Environment Variables with Gradle" width="845" height="321" /></a></p>
<p>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.</p>
<p><button class="call-to-action"><a href="https://appcircle.io/start" target="_blank" rel="noopener">Start Using Appcircle Now</a></button></p>


Streamline your Android CI/CD process now!

How to Use Environment Variables with Gradle

Related Posts

Best Mobile Continuous Integration and Continuous Delivery (CI/CD) Tools

Automate App Store Deployment to App Store, Google Play, and Huawei App Gallery with Appcircle

Continuous Deployment for Android Apps: A Complete Guide with Appcircle

How Mobile DevOps Enhances iOS and Android Pipelines?

How to Use Environment Variables with Gradle

Related Posts

Best Mobile Continuous Integration and Continuous Delivery (CI/CD) Tools

Automate App Store Deployment to App Store, Google Play, and Huawei App Gallery with Appcircle

Continuous Deployment for Android Apps: A Complete Guide with Appcircle

How Mobile DevOps Enhances iOS and Android Pipelines?

Subscribe to Appcircle Circle