1 /* 2 * Copyright (C) 2023, The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 #pragma once 18 19 #include <string> 20 21 #include "aidl_language.h" 22 #include "code_writer.h" 23 #include "options.h" 24 25 // This is used to help generate code targeting to any language 26 27 namespace android { 28 namespace aidl { 29 30 enum class CommunicationSide { 31 WRITE = 0x1, 32 READ = 0x2, 33 BOTH = WRITE | READ, 34 }; 35 36 constexpr const char* kDowngradeComment = 37 "// Interface is being downgraded to the last frozen version due to\n" 38 "// RELEASE_AIDL_USE_UNFROZEN. See\n" 39 "// " 40 "https://source.android.com/docs/core/architecture/aidl/stable-aidl#flag-based-development\n"; 41 42 constexpr int kDowngradeCommunicationBitmap = static_cast<int>(CommunicationSide::BOTH); 43 44 // This is used when adding the trunk stable downgrade to unfrozen interfaces. 45 // The kDowngradeCommunicationBitmap constant can be used to only modify one side of 46 // the generated interface libraries so we can make sure both sides are forced 47 // to behave like the previous unfrozen version. 48 // BOTH is standard operating config, but can be switched for testing. 49 bool ShouldForceDowngradeFor(CommunicationSide e); 50 51 // currently relies on all backends having the same comment style, but we 52 // could take a comment type argument in the future 53 void GenerateAutoGenHeader(CodeWriter& out, const Options& options); 54 55 } // namespace aidl 56 } // namespace android 57